0%
Loading...
NolimitHost

How to Change the Map on Your BeamMP Server

Last updated: September 18, 2026

This guide shows you how to change the map your BeamMP server loads. The map is set with the Map value in ServerConfig.toml and must point to a map that is installed on the server.

Before You Start

Stop your server from the Console page. BeamMP loads the map on startup, so a change only takes effect after a restart.

Option A: Change the Map in the Game Panel

  1. Log in to the NolimitHost Game Panel and select your BeamMP server.
  2. Open the Startup tab and edit the Map field to a map path, for example /levels/east_coast_usa/info.json.
  3. Click Save and start the server.

Option B: Edit ServerConfig.toml

  1. In the left sidebar, click Files and open ServerConfig.toml.
  2. Find the Map line and set it to the map you want: 
    [General]
Map = "/levels/east_coast_usa/info.json"
  3. Save the file and start the server.

Included (Vanilla) Maps

Every map path ends in /info.json.

Map Path
Gridmap v2/levels/gridmap_v2/info.json
East Coast, USA/levels/east_coast_usa/info.json
West Coast, USA/levels/west_coast_usa/info.json
Italy/levels/italy/info.json
Utah/levels/utah/info.json
Johnson Valley/levels/johnson_valley/info.json
Jungle Rock Island/levels/jungle_rock_island/info.json
Industrial Site/levels/industrial/info.json
Small Island, USA/levels/small_island/info.json
Hirochi Raceway/levels/hirochi_raceway/info.json
Automation Test Track/levels/automation_test_track/info.json
Derby Arena/levels/derby/info.json
Driver Training/levels/driver_training/info.json

Using a Custom Map

  1. Download the map mod as a .zip file. Do not extract it.
  2. Stop the server, then upload the .zip to Resources/Client using Files or SFTP. See Install Mods.
  3. Set Map to the path inside the mod, usually /levels/your_map_name/info.json.
  4. Start the server. Clients download the map automatically on connect.
Important: The Map path must exactly match the map's location inside the mod's .zip. If it does not, the server fails to load the map and players are disconnected.