How to Add a Custom Map to Your BeamMP Server

This article covers changing your BeamMP server's map, both to a stock map that ships with BeamNG.drive and to a custom map you upload yourself.

A custom map is a two-step job: upload the map file, then point the server at the correct path inside it. The second step is where most people get stuck, so read it carefully.

Using a stock map

Stock maps are included with BeamNG.drive and do not need to be uploaded. You only have to point the server at them.

Set the Map field in the Startup tab to one of the paths below, then restart the server. Common stock maps:

/levels/gridmap_v2/info.json
/levels/west_coast_usa/info.json
/levels/east_coast_usa/info.json
/levels/italy/info.json
/levels/utah/info.json
/levels/jungle_rock_island/info.json
/levels/small_island/info.json
/levels/hirochi_raceway/info.json
/levels/industrial/info.json
/levels/automation_test_track/info.json
/levels/johnson_valley/info.json
/levels/derby/info.json

This is not the full list. Check the BeamMP wiki for the current set of stock maps if the one you want is not here.

Set the Map in the Startup tab, not in the config file. The map is a panel-managed setting. If you change it only in ServerConfig.toml, it will revert to the Startup value on the next restart. See the server basics article for why.

Adding a custom map

Step 1: Upload the map

1. Download the custom map as a .zip file. Keep it as a .zip. Do not extract it. BeamMP serves the zip directly to players.
2. Open the Files tab and go to Resources/Client. Create the folder if it does not exist. This is the same folder used for vehicle mods.
3. Upload the map .zip into Resources/Client. Use SFTP for large map files (over 100MB - required). SFTP details are in the Settings tab.

Step 2: Find the map's folder name

The map path is case-sensitive and must match the folder name inside the zip exactly. To find it:

1. Open the map .zip on your computer (you do not need to extract it, just look inside).
2. Look for the levels folder. Inside it is a folder named after the map, for example my_custom_map.
3. That folder name is what you need. Inside it there should be an info.json file.

So the structure inside the zip looks like:

levels/
  my_custom_map/
    info.json
    ...

Step 3: Point the server at the map

1. Go to the Startup tab.
2. Set the Map field to the path built from the folder name you found:

   /levels/my_custom_map/info.json

   Replace my_custom_map with the exact folder name from the zip, matching capitalization exactly.
3. Restart the server from the Console tab.

When players join, they download the map zip automatically and load into it.

Troubleshooting

The map keeps reverting to the old one after a restart.
You set it only in ServerConfig.toml. The map is managed by the panel, so set it in the Startup tab instead.

The server crashes or fails to start after changing the map.
The path is almost always the problem. Check that:

• The path matches the folder name inside the zip exactly, including capitalization.
• The path starts with /levels/ and ends with /info.json.
• The zip is in Resources/Client and is still a .zip, not extracted.

Players load in but the map is wrong or falls back to gridmap.
The path does not match a valid level. Reopen the zip, confirm the exact folder name and that info.json sits directly inside that folder, and correct the Map path. It is also possible that the map is no longer compatible on the current BeamMP/BeamNG version.

The zip has more than one level inside it.
Pick the one you want and use its folder name in the Map path. The server loads the level you point to.

If you are still stuck, open a ticket with the map name, the exact Map path you set, and your Console log from the failed start.