How To Change The Map / Install Custom Maps On BeamMP

There are two ways to change what map your BeamMP server runs. If you just want one of BeamNG.drive's built-in maps, it works out of the box with no upload needed. If you want a custom community map, you'll need to upload it first and then point your server at it.

Switching To a Default Map

Default maps are already included with BeamNG.drive, so there's nothing to install. Just update the Map setting in ServerConfig.toml to one of the paths below, save, and restart your server.

• /levels/gridmap_v2/info.json — Grid Map
• /levels/west_coast_usa/info.json — West Coast USA
• /levels/east_coast_usa/info.json — East Coast USA
• /levels/italy/info.json — Italy
• /levels/utah/info.json — Utah
• /levels/jungle_rock_island/info.json — Jungle Rock Island
• /levels/industrial/info.json — Industrial Site
• /levels/small_island/info.json — Small Island
• /levels/smallgrid/info.json — Small Grid
• /levels/hirochi_raceway/info.json — Hirochi Raceway
• /levels/johnson_valley/info.json — Johnson Valley
• /levels/automation_test_track/info.json — Automation Test Track
• /levels/driver_training/info.json — Driver Training
• /levels/derby/info.json — Derby

Installing a Custom Map

Custom maps from the modding community go through your server's Resources/Client folder, the same place vehicle mods live.

1. Download the map as a .zip file. Do not extract it.
2. Stop your server on the MintServers panel.
3. Open the Files tab and navigate to the Resources/Client folder:
   📁 BeamMP-Server

   📁 Resources

   📁 Client (you are here)
4. Upload the .zip file into that folder.
5. Open the zip file (without extracting it) and look inside the levels folder. There should be exactly one folder inside, named after the map, for example mymap or custom_track. Note this name exactly as written.
6. Open ServerConfig.toml and set Map to /levels/MAPNAME/info.json, replacing MAPNAME with the folder name from the last step:
   📁 BeamMP-Server

   📄 ServerConfig.toml (edit the Map field here)
7. Save and start your server.

Finding the Map Name When It's Not Obvious

If the folder name inside the zip isn't clear, or the map doesn't load after following the steps above, you can find the exact name another way:

1. Install the map in singleplayer BeamNG.drive and load into it.
2. Open the in-game console with the tilde key (~). If you're on a non-US keyboard, check the Toggle System Console binding under Options > Controls > Bindings > General Debug.
3. Run print(getMissionFilename()).
4. Use the path it prints as your Map value.

How Auto-Download Works

Once a map is in Resources/Client and set as your active Map, players don't need to do anything on their end.

1. BeamMP checks whether the connecting player already has the map.
2. If they don't, it downloads automatically from your server.
3. Once it finishes, they spawn straight into the map.

The first connection after a map change will be slower while it downloads, especially for large, detail-heavy maps. Every player after that connects instantly, since the map is now cached on their end. Keep file size in mind if your server is public — a huge map means a long wait for every new player's first join.

Troubleshooting

• Server won't start after changing the map: Double-check your Map path for typos and make sure it ends in /info.json.
• Players load into an empty void: The map zip is likely corrupted or incomplete. Re-download it and re-upload.
• Map takes forever to load: Large, detailed maps need more RAM. Make sure your plan has enough headroom for the map you're running.
• Map doesn't load even though the path looks right: Check capitalization. Map paths are case-sensitive and have to match the folder name inside the zip exactly.

Once your map is set and players are downloading it without issues, you're all set. If a custom map still won't load correctly, no worries! Just open a support ticket and our team will take a look.