How to Change the Map on Your BeamMP Server
All default BeamMP maps and how to install custom maps — with step-by-step upload and configuration.
Default Maps (No Installation Needed)
These maps are built into BeamNG.drive — just change the Map setting:
| Map | Config Path |
|---|---|
| Gridmap V2 (default) | /levels/gridmap_v2/info.json |
| West Coast, USA | /levels/west_coast_usa/info.json |
| East Coast, USA | /levels/east_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 |
| Automation Test Track | /levels/automation_test_track/info.json |
| Industrial Site | /levels/industrial/info.json |
| Derby Arenas | /levels/derby/info.json |
| Small Island, USA | /levels/small_island/info.json |
| Driver Training | /levels/driver_training/info.json |
| Port | /levels/port/info.json |
In the XGamingServer Panel, click Startup and find the Map field. Enter the path from the table above.
In Files, open ServerConfig.toml and change the Map line:
Map = "/levels/west_coast_usa/info.json"Restart your server after changing.
Installing a Custom Map
Custom maps from the BeamNG community are distributed as .zip files. Players auto-download custom maps when joining — no manual client install needed.
Download the map
Get the custom map .zip file from the BeamNG modding community (e.g., BeamNG.drive forums or mod sites).
Upload to the server (DO NOT EXTRACT)
In the XGamingServer Panel, click Files in the sidebar. Navigate to Resources/Client/ and click Upload. Upload the .zip file — do not extract it.
⚠️ The file must stay as a
.zip. BeamMP serves it to clients directly.
Find the map's folder name
You need to know the folder name inside the zip. Open the zip locally on your PC — look inside the levels/ directory for the map folder name (e.g., my_custom_map).
Set the map in config
In Startup or ServerConfig.toml, set the map path:
Map = "/levels/my_custom_map/info.json"⚠️ Case-sensitive — the path must match the folder name inside the zip exactly, including capitalization.
Restart
Go to Console and restart your server. The map is now active and players will auto-download it on join.
Related Guides
How is this guide?
How to Connect to Your BeamMP Server
How to join your BeamMP server via the server browser or direct IP — including finding your server IP from the panel.
How to Install Vehicle Mods on Your BeamMP Server
How to add custom vehicle mods and client-side content to your BeamMP server — upload, reload, and manage.