Installing Server Plugins

New to Vyper Hosting?

Popular BeamMP server plugins like Cobalt Essentials and Nickel are available in one click via the Mod Installer in the Vyper Hosting game panel. Get a BeamMP server on our website.

BeamMP supports server-side Lua plugins placed in Resources/Server/. Plugins can add custom commands, chat filters, race timers, economy systems, Discord bridges, and much more. They run only on the server - players never download them.

Mod Installer (Recommended)

The Mod Installer includes the most popular BeamMP server plugins pre-packaged and ready to go.

1. In your Vyper Hosting panel, click Mods.
2. Set the dropdown to Server.
3. Search for the plugin by name or browse the list.
4. Click Install.
5. Restart the server from the Console tab.

File placement is handled automatically. You can also update installed plugins with one click from the Installed view.

File Manager

For plugins not available in the Mod Installer.

1. Download the plugin .lua file(s) from a trusted source.
2. In your panel, go to Files → Resources → Server.
3. Click Upload and select the plugin file(s).
4. Restart the server.

SFTP

1. Connect via FileZilla, WinSCP, or Cyberduck.
2. Upload the plugin file(s) to /Resources/Server/.
3. Restart the server.

Plugin Configuration

Most plugins have a config section at the top of their .lua file, or generate a separate config file (e.g. config.json) in their folder on first run. Edit the config, save, and restart to apply.

Organising Plugins

BeamMP recursively loads all .lua files from Resources/Server/ and its subdirectories. For servers with many plugins, use subfolders:

• DirectoryResources/

  • DirectoryServer/

    • DirectoryCobaltEssentials/

      • …
    • DirectoryNickel/

      • …
    • chatfilter.lua
    • discord_bridge.lua

Disabling a Plugin

Rename plugin.lua to plugin.lua.disabled - BeamMP skips files that don’t end in .lua. The plugin won’t unload until after the next restart.

Troubleshooting

Problem	Potential Fix
Plugin not loading	Check the Console for Lua errors; verify the file is in Resources/Server/
Lua error on startup	Syntax error in the plugin - check the error line number in the console
Commands not working	Ensure you have the required permission role; check the plugin’s README
Server crashes on start	Isolate by renaming plugins to .disabled one at a time

Popular Plugins

Cobalt Essentials Full admin GUI, roles, permissions, and an extensions ecosystem.

Nickel Lightweight player tracking, whitelist, and quick moderation commands.

Lua Scripting Write your own custom plugins for your server.