How to Upload, Install, and Configure Custom BeamMP Maps

BeamMP servers send BeamNG.drive mods, maps included, to players when they join. A custom map is a mod: a .zip file in your server's Resources/Client folder. This guide covers adding a custom map, making it the server's map, and fixing common problems.

Step 1: Get the map

• Download the map from a source you trust, such as BeamNG's mod repository.
• Check that it's a single .zip file and that it's a map (level) mod, not only vehicles. Don't extract it.
• Check it works in single-player BeamNG.drive first.

Step 2: Add it to your server

1. Sign in to the control panel at panel.chicagoservers.co and open your BeamMP server.
2. Open the Mods tab. Paste the map's download link under Add a mod from its download link and click Add.
   Or upload the .zip to Resources/Client on the Files tab, or over SFTP for big maps (see How to connect to your server's SFTP). Leave it as a .zip.

Step 3: Make it the server's map

1. On the Mods tab, click Find maps in the mods. The panel looks inside your mods for maps.
2. Click Play and the map's name (for example Play bajarama) next to the mod.
3. Click Restart at the top of the page, and watch the Console tab for errors.

The panel sets the map for you: it fills in Map from a mod on the Startup tab, and writes Map = "/levels/<name>/info.json" to ServerConfig.toml every time the server starts. Don't edit Map in ServerConfig.toml yourself: the Startup tab's setting replaces it at the next start. If you know the map's level name (the folder inside the zip's levels folder), you can also type it into Map from a mod and click Save startup.

To go back to one of BeamNG's own maps, click Use the Startup tab's map on the Mods tab and choose the map under Map on the Startup tab.

Step 4: Check it in game

Launch BeamMP and join your server from the server browser, or with its address from the top of your server's page. Check that the right map loads.

Common problems

• The server won't start, or the map doesn't load: check the Console tab for errors, check that the map works in single-player, and check that the mod is switched on on the Mods tab. To get going again, click Use the Startup tab's map and restart.
• The map didn't change: check that the map shows Playing on the Mods tab and that you restarted the server. Don't change Map in ServerConfig.toml: the panel sets it from the Startup tab.
• Players stuck loading: big maps take a long time to download the first time. Keep your mods lean.

Make a backup on the Backups tab before big changes, and test your maps again after BeamMP or BeamNG.drive updates. For more on mods, see How to install mods on your BeamMP Server.

If you contact us about a map, tell us the map's file name and any errors from the Console tab.

Need help? Open a support ticket and we'll take a look.