Get your AuthKey
- Sign in to Keymaster. Open keymaster.beammp.com and log in with your Discord account.
- Make a key. Open Keys and press +, then copy the key it makes.
- Paste it into Settings. In your server's Settings, paste the key into AuthKey and press Save configuration. It's stored encrypted and never shown again.
Every BeamMP server needs a key, and the server can't start without one. Keys are free, and one key runs one server at a time.
Set up your server
- Order the server. Choose BeamMP, the location closest to your players and a plan. BeamNG.drive's physics runs on each player's PC, so the Starter plan suits most groups.
- Name it. Set the Server name, a Description and Tags such as Freeroam,Drift,Modded so players can find it. BeamMP's colour codes, like ^4, work in the name.
- Choose the map and limits. Pick one of BeamNG.drive's maps under Map, then set Player slots (up to 100) and Cars per player (1 to 20).
- Choose who can find it. Public listing puts the server in BeamMP's server list; with it off, players join by its address. Allow guests lets players without a BeamMP account join.
- Save and restart. Press Save configuration and restart the server. Settings take effect at the next start.
Add vehicle and map mods
Upload each mod's .zip, as you downloaded it, to Resources/Client in Files & SFTP: up to 96 MB in the browser, or up to 1 GB each over SFTP. Every file passes a safety scan before your server gets it. When your uploads show Passed safety scan, restart the server: players download the mods from it as they join.
For a map from a mod, upload its zip, choose "A map from a mod" under Map and enter its level folder in Mod map folder: the name in levels/<folder>/info.json inside the zip, like ks_nord.
Add Lua plugins
Server-side Lua plugins add game modes, chat commands and more. Upload each one over SFTP to its own folder in Resources/Server, such as Resources/Server/MyPlugin/main.lua, and restart the server.
How players join
Players start BeamNG.drive through the BeamMP launcher. With Public listing on, they find your server in the server list; otherwise they choose Direct Connect and enter the connect address from your dashboard.
Console and updates
The dashboard console kicks players, sends messages and checks the server.
With Automatic updates on, the server starts the newest BeamMP server release each time it starts, so restart it after BeamMP updates.