BeamMP Map Names: Every Map Code and How to Change Your Server Map
Every BeamMP map is set with a single line in your server config, and it always uses the same format:
/levels/MAP_FOLDER_NAME/info.json
That MAP_FOLDER_NAME is the folder name inside the map, not the name of the mod, not the name you see in-game, and not the filename of the zip you downloaded. Getting this one value wrong is the single most common reason a BeamMP server won't boot after a map change.
Below is the full list of built-in map codes, followed by how to change your map and how to find the code for any custom map.
Built-in BeamMP Map Codes
These maps ship with BeamNG.drive. Every player already has them, so there's nothing to upload — just paste the code into your config and restart.
| Map | Map Code |
|---|---|
| East Coast, USA | /levels/east_coast_usa/info.json |
| West Coast, USA | /levels/west_coast_usa/info.json |
| Italy | /levels/italy/info.json |
| Utah, USA | /levels/utah/info.json |
| Johnson Valley | /levels/johnson_valley/info.json |
| Hirochi Raceway | /levels/hirochi_raceway/info.json |
| Jungle Rock Island | /levels/jungle_rock_island/info.json |
| Grid, Small, Pure | /levels/gridmap_v2/info.json |
| Automation Test Track | /levels/automation_test_track/info.json |
| Industrial Site | /levels/industrial/info.json |
| Small Island | /levels/small_island/info.json |
| Derby Arenas | /levels/derby/info.json |
| Driver Training | /levels/driver_training/info.json |
| Small Grid | /levels/smallgrid/info.json |
| Cliff | /levels/cliff/info.json |
Note that older guides list /levels/gridmap/info.json. That's the legacy grid map — current BeamNG.drive versions use gridmap_v2.
Which Maps Do Real Servers Actually Run?
We host thousands of BeamMP servers, so we pulled the live map setting across all of them. The distribution is far more lopsided than most "best maps" lists suggest:
| Map | Share of servers |
|---|---|
| East Coast, USA | ~39% |
| West Coast, USA | ~25% |
| Italy | ~9% |
| Utah, USA | ~4% |
| Grid, Small, Pure | ~3% |
| Hirochi Raceway | ~2% |
| Jungle Rock Island | ~1% |
| Johnson Valley | ~1% |
Two things worth taking from this. First, East Coast USA is the most-run BeamMP map, not West Coast USA — its tighter road network keeps players running into each other instead of scattering across a huge map. Second, roughly 7% of servers run a community map, and those are spread across more than 250 different maps. If you're picking a map to attract players, the built-in maps are what most people already have installed and can join instantly.
How to Change Your Map
- Open the Config Editor tab in your server panel.
- Find the Map field.
- Paste the full map code, including the leading slash and
/info.json. - Save, then restart the server.
Changing the config alone doesn't switch the map — the server only reads it at boot, so the restart is required. Players will download any custom map files automatically when they connect.
Finding the Code for a Custom Map
Custom maps are where nearly all the confusion comes from, because the code has nothing to do with the file you downloaded.
- Download the map as a
.zipfrom the BeamNG mod repository. Don't unzip it for upload. - Upload the zip through the Mod Manager tab, or to
Resources/Clientin the File Manager. - To find the map code, open the zip on your computer and look inside the
levels/folder. The name of the folder in there is yourMAP_FOLDER_NAME.
So if a mod is called Super Mountain Road v3.zip but the folder inside is levels/smr_v3/, your map code is /levels/smr_v3/info.json — not anything resembling the zip's filename.
Custom map folder names are also case-sensitive. If the folder is LakeFaroe, then /levels/lakefaroe/info.json will not load.
Common Mistakes — and Why Your Server Won't Warn You
This is the part that catches people out: BeamMP does not validate your map path. A wrong value doesn't produce an error. The server boots, reports ALL SYSTEMS STARTED SUCCESSFULLY, and appears completely healthy in the log — the map just silently never loads for players. So "no errors in my log" tells you nothing here.
These are the malformed values we see most often on real servers:
| What people enter | Problem |
|---|---|
/Mods/baja_1000.zip/info.json | Points at the zip, not the level folder inside it |
/repo/glamis_snca.zip | Same — the mod filename is not the map path |
levels/italy/info.json | Missing the leading slash |
/levels/italy | Missing /info.json |
/level/italy/info.json | level instead of levels |
/levels/west_coast_usa/info.Json | Capital J — the filename is info.json |
/levels/Utah/info.json | Wrong case — built-in map folders are lowercase |
/levels/cb_rp3/main.level.json | Wrong filename — it's always info.json |
West Coast, USA | The in-game display name, not the folder path |
gridmap_v2 | Bare folder name, without the /levels/ prefix or /info.json |
If your map isn't loading, check your value against this table before anything else — a path typo is by far the most common cause, and it's the one thing the server won't flag for you.
Troubleshooting
Server crashes or won't boot after changing the map. The path is almost certainly wrong. Re-check it character by character against the tables above, especially the leading slash and the /info.json suffix.
Players load into an empty void. The map uploaded but its files are incomplete or the map isn't compatible with your BeamNG version. Re-download it and re-upload.
The map didn't change at all. You saved the config but didn't restart, or you uploaded the mod while the server was running — BeamMP reads its mod list at boot only. Restart the server.
Map takes a long time to load. Large, detailed community maps use noticeably more RAM than built-in maps. If your server is struggling, see our BeamMP performance guide.
Still stuck? Open a ticket with the exact map code you entered and we'll check it against the server files for you.