Setting up your BeamMP server

BeamMP adds multiplayer to BeamNG.drive. Your server runs as soon as it is created, but it needs an AuthKey before it can appear in the BeamMP server list. Everything below is done in our game panel.

1. Get your AuthKey

1. 1Go to keymaster.beammp.com and sign in with your BeamMP forum account.
2. 2Open the Keys section and create a new key for your server.
3. 3Copy the key. Keep it private, as anyone with it can run a server under your name.

2. Edit ServerConfig.toml

Stop the server, then open ServerConfig.toml in the file manager. These are the settings you will want to change, all under the [General] section:

• AuthKey: paste your key between the quote marks.
• Name: your server's name in the server list.
• Description: a short line telling people what your server is about.
• MaxPlayers: the most players that can join at once.
• MaxCars: how many vehicles each player can spawn at the same time.
• Map: the level to load, for example /levels/gridmap_v2/info.json, /levels/west_coast_usa/info.json, /levels/east_coast_usa/info.json, /levels/italy/info.json or /levels/utah/info.json.
• Private: set to false to appear in the public server list, or true to keep it hidden so only people with your address can join.

Keep the quote marks around text values, and leave the Port setting as it is, since it has to match the port shown in your panel. Save the file and start the server. The console will confirm that it has authenticated with BeamMP.

3. Add mods and maps

1. 1Stop the server.
2. 2Upload mod .zip files (vehicles, maps and so on) into the Resources/Client folder. Upload them as they are, without unzipping.
3. 3For a custom map, set Map in ServerConfig.toml to that map's level path, which is usually /levels/ followed by the map's folder name and /info.json.
4. 4Start the server. Players download your mods automatically when they join.

Server-side Lua plugins go in Resources/Server instead. Keep mods to what you really need, as every player has to download them all before they can join.

Joining your server

Players need BeamNG.drive and the BeamMP launcher. They can find you in the server list if Private is set to false, or use Direct Connect with the IP and port shown in our game panel.