Skip to main content
To install a custom map on a FREAKHOSTING BeamMP server, upload the map’s .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 /info.json at the end:
The field takes up to 64 characters.
4

Restart

Restart the server. Players get the map on their next join.
BeamMP Files page at Resources with the Client folder used for custom map zip files

The Client and Server folders in Resources

Set the map on Startup, not in ServerConfig.toml. The panel writes Map into the file at every start.

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 in Resources/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.

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:

Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!

Last Updated: November 2026