How to add a Custom map to your BeamMP Server?

Adding a custom map to your BeamMP server lets you and your players enjoy unique locations, racetracks, and off-road terrains together. Follow the steps below to properly install and load your custom map.

Step 1: Locate your server folder

  1. Go to your BeamMP server directory.

This is the folder that contains files like:

BeamMP-Server.exe
ServerConfig.toml
Resources/

  1. Inside this directory, find or create the folder named Resources (If this doesn't exist yet)

Step 2: Upload your map

Uploading maps works exactly the same as uploading mods.

  1. Upload your map inside the Resources/Client/ folder.

  2. Make sure you uploaded the .zip file

Try to avoid spaces or special characters in your file names, use underscores '_' instead.

Make sure you've tested the map in single-player first, so you know it works.

  1. Once you uploaded your files, it would look like this:

Resources/
 └── Client/
      ├── MyCustomMap.zip

Step 3: Setting up the map

To make sure your server runs your newly added map, you've to change your startup parameters. You can do so via our gamepanel.

  1. Head over to "Startup Parameters"

  2. Look for the "Map" section.

  3. Enter the following:

levels/mycustommap/info.json

Normally "mycustommap" should be the name of your zip folder (As most of the time the creators use the same name inside the file aswell).

If this doesn't work, open your .zip file on your computer and check how the folder is called within the levels folder.

Step 4: Start/Restart your server

  1. Start or restart your server via our gamepanel.

  2. Once a map has been loaded, you should see something like this in your console:

[INFO] Loading map: levels/mycustommap/info.json
[INFO] Map successfully loaded!

Step 5: Test your map

  1. Once you've restarted your server, you can join your server and test the map you've installed.

If a map doesn't load properly or cause issues, please make sure to remove it from your server and restart again.