.zip to Resources/Client in Files, look inside the zip for the folder under levels, then set Map on the Startup page to /levels/<foldername>/info.json and restart. Players download the map automatically when they join.
Before you start
- Download the map mod as a
.zip, for example from the BeamNG.drive mod repository. Keep it zipped. - Make a backup.
How to install a custom BeamMP map
1
Find the map's folder name
On your PC, open the
.zip without unpacking it. Open the levels folder inside and note the name of the folder there exactly, for example my_city. This is not always the same as the file name.2
Upload the zip
In the Game Panel, open Files, go to
Resources/Client and click Upload. Choose the map .zip. Use SFTP for very large maps.3
Set the Map variable
Click Startup and enter the path in Map, keeping The field takes up to 64 characters.
/info.json at the end:4
Restart
Restart the server. Players get the map on their next join.

The Client and Server folders in Resources
What if the map name doesn’t work?
If players load the wrong map or get an error, the folder name is probably wrong. Get the exact name from the game:1
Load the map alone
Install the map in your own BeamNG.drive and load it in singleplayer.
2
Open the console
Press the tilde key (
~) to open the game console.3
Print the map path
Run this command and copy the result into Map:
Frequently asked questions
Can I install more than one custom map?
You can upload several map zips, but the server runs one map at a time: the one in Map. Every zip inResources/Client is still downloaded by players, so remove maps you don’t use.
How do I go back to a stock map?
Set Map to a stock path such as/levels/west_coast_usa/info.json and restart. See change the map.
Why does it take so long to join after adding a map?
Players download the map zip on their first join. Big maps take longer, depending on each player’s connection.Related guides
BeamMP server guide
Every BeamMP page in one place.
Change the map
Stock maps and their paths.
Install mods
Vehicle mods and plugins.
Optimise bandwidth
Faster joins with big maps.
Tested by the FREAKHOSTING team on our Game Panel on 3 November 2026 (BeamMP Server v3.9.3). Map steps checked against the official BeamMP documentation. Steps may differ slightly if the game changes.
Need Extra Help?
If you encounter any issues, our support team is ready to assist:- Live Chat: Quick assistance via our website.
- Support Ticket: Open a Ticket
- Discord: Join our Community
- Email: support@freakhosting.com
Last Updated: November 2026