How to install server plugins on your BeamMP server

Click Upload plugin on the Server plugins card of the Mods & maps tab, choose the plugin's .zip, then restart the server. BeamMP server plugins are Lua scripts that run on the server only, for moderation, commands or game modes. Players install nothing.

Upload a plugin

1. Download the plugin as a .zip from its author.
2. Open your server in the panel and click the Mods & maps tab.
3. On Server plugins, click Upload plugin and choose the zip.
4. Wait for the install card to say the plugin is installed: Restart the server to load it.
5. Restart the server.

The panel unpacks the zip into its own folder in Resources/Server. BeamMP loads the .lua files at the top of that folder.

If the upload is refused

The install card says why, for example:

• No .lua file was found at the top of this zip, so BeamMP would load nothing. Check that it is a server plugin. A client mod belongs under Add a mod instead: How to add mods to your BeamMP server.
• This zip is a whole Resources folder. Add its client mods and its server plugins one at a time.
• This zip was refused for safety: the zip holds a path outside its folder, a link, an encrypted file or too many files.

A plugin row that says No .lua file at the top of this folder, so BeamMP loads nothing from it. was probably zipped one folder too deep.

Switch a plugin off or remove it

Open the plugin's menu, Actions for the plugin:

• Switch off keeps the plugin's files but BeamMP stops loading it. Switch on brings it back.
• Remove deletes the plugin's folder and everything in it, including data it saved. Take a backup first if you may want it back: How to back up and restore your BeamMP server.

Restart the server after either change. The card says Changes load at the next restart.

The PlayNHost plugin

The plugin PlayNHost is marked Managed by PlayNHost: Players, bans and chat on the Players page come from it. It is put back at every start. It has no menu. To run your server without it, turn off PlayNHost Tools in Settings, Game Settings, and restart. The Players page then has no live list, kick or chat.

Good to know

• For moderation commands, Nickel installs in one click: How to install Nickel moderation on your BeamMP server.
• A plugin with an error shows a line starting [LUA ERROR] in the Console, with the plugin's file and line. The server keeps running.
• Plugins can also be copied into Resources/Server with Files or SFTP: one folder per plugin, with its .lua files at the top of the folder.