Changing the map on your BeamMP server is simple once you know where the map file needs to go and how to set the correct map path in your server config.
This guide covers how to switch your BeamMP server to a different map, including custom modded maps.
Before You Start
Before changing your map, make sure:
- the map is installed on your server
- the map is installed on the client side for anyone joining, if required
- you know the correct map path
If the map is a custom modded map, it must be uploaded correctly to your server first.
Step 1: Upload the Map to Your BeamMP Server
If you are using a custom map, upload the map files to your server first.
This is usually done through your panel file manager or SFTP, depending on how you manage your server.
Make sure the map files are placed in the correct mods or resources location used by your BeamMP setup.
Step 2: Find the Correct Map Name or Path
To load a map properly, you need to use the correct map identifier in your configuration.
For default BeamNG maps, this is usually a path similar to:
/levels/gridmap_v2/info.jsonCustom maps will use their own level path depending on how the map is packaged.
If the map path is wrong, the server may fail to load the map correctly.
Step 3: Open Your BeamMP Server Config
Open your ServerConfig.toml file.
Find the section for the map setting.
It will usually look something like this:
Map = "/levels/gridmap_v2/info.json"Replace the current map path with the one for the map you want to use.
Step 4: Save the Changes
After updating the map value, save the ServerConfig.toml file.
Double-check that:
- the path is typed correctly
- there are no missing characters
- the map actually exists on the server
Step 5: Restart Your BeamMP Server
Once the config has been updated, restart your BeamMP server.
The server should now attempt to load the new map when it starts.
If the map does not load, check your server console for errors and confirm the map path is correct.
Common Problems
Map does not load
This usually means the map path is incorrect or the map files were not uploaded properly.
Players cannot join the map
If the map is custom, players may also need the correct content installed on their side depending on the setup.
Server starts on the old map
Make sure you saved the config file correctly and fully restarted the server after making the change.
Video Guide
If you want a visual walkthrough, follow the video tutorial for changing the map on your BeamMP server to a custom modded one.
Final Notes
To change the map on your BeamMP server, you simply need to:
- upload the map if it is custom
- set the correct map path in
ServerConfig.toml - save the file
- restart the server
Once done, your BeamMP server should launch on the new map.