How to Add a Custom Map to Your BeamMP Server

Updated 10 June 2026 · By Host Havoc Technical Support Team

Custom maps extend the variety of terrain and tracks available on your server. After uploading the map file via FTP and updating ServerConfig.toml, players will automatically download the map when they join.

Before you start: Stop your server before making any configuration changes.

Download and upload the map

  1. Download the map .zip file from beamng.com/resources.
  2. Connect to your server using an FTP client.
  3. Upload the map .zip file to ./Resources/Client/.

Find the map name

  1. Open the map .zip file on your PC.
  2. Look for a levels folder and open it.
  3. Note the name of the folder inside. For example, cool_canyon.

Update the server configuration

  1. Log in to the Game Control Panel.
  2. Navigate to your BeamMP server.
  3. Click Configuration Files.
  4. Click the Config Editor icon for ServerConfig.toml.
  5. Set the Map field to /levels/<map-name>/info.json. For example: /levels/cool_canyon/info.json.
  6. Click Save.
  7. Start your server.

Players will automatically download the map when they connect to the server.

Troubleshooting

  • Map not loading. Double-check the folder name inside the levels directory in the .zip file. The name must match exactly, including underscores and capitalisation.
  • Players not downloading the map. Confirm the .zip file is in ./Resources/Client/ and that the server is running.