How to use a custom map on your BeamMP server

Upload the map's .zip on the Mods & maps tab, open its row menu and choose the map under Use as the server map, then restart the server. The panel reads the zip and fills in the exact map path BeamMP needs, so you never type it.

Add the map and use it

1. Open your server in the panel and click the Mods & maps tab.
2. Under Add a mod, upload the map's .zip or paste its download link: How to add mods to your BeamMP server.
3. Wait until the row stops saying Reading. It then shows Map and the map's folder name.
4. Open the row's menu, Actions for the mod. Under Use as the server map, click the map. A zip can hold more than one.
5. Restart the server. The page says Map saved. Restart the server to load it.

The row now has the badge Current map.

Or pick it on the Server map card

The Server map card on the same page lists every map your server can run: the maps found in your mods first, then the maps that come with BeamNG.drive. Pick one, click Use this map and restart.

The same list is in step 4 of the Go live card on Overview.

The stock maps

Every player has these, so they need no download: West Coast, USA; Italy; East Coast, USA; Utah, USA; Johnson Valley; Grid Map; Jungle Rock Island; Hirochi Raceway; Automation Test Track; Derby Arenas; Industrial Site; Small Island, USA; Driver Training; Grid, Small, Pure; and Cliff. Port is marked (not seen on servers) here and not checked on the Go live card: it has not been seen running on servers yet. A new server runs Grid Map.

If the map does not load

• The Server map card says The map set now (...) is not a stock map or in a mod that is switched on. Players cannot load it. The map's mod was removed or switched off, or the name in Map is wrong. Pick a map from the list again.
• The row says the zip holds an extra folder, or no map was found: the mod is packed wrongly. Get a fresh copy from where you downloaded it.
• Two zips hold the same map folder: The same map folder is also in ... Only one of them loads. Remove one.
• To prove the rest of the server is fine, pick Grid Map and restart.

Good to know

• A map mod is downloaded by every player on their first join, and maps are often large: How to make players join faster on your BeamMP server.
• Choosing a map needs the settings permission Change startup.
• The Map field in Settings, Game Settings holds the same value, written like /levels/west_coast_usa/info.json.