How to Upload, Install, and Configure Custom BeamMP Maps Print

How to Upload, Install, and Configure Custom BeamMP Maps

Overview

BeamMP servers load BeamNG.drive maps (levels) from the server only. Client-side mods are not supported—all maps must be installed server-side.

This guide covers:

• Preparing a custom BeamNG map

• Uploading it to your ChicagoServers BeamMP server

• Setting it as the default map

• Troubleshooting common issues

Requirements

Before you begin, make sure you have:

• An active BeamMP server with ChicagoServers

• FTP/SFTP access to your server

• A legitimate Steam copy of BeamNG.drive (required by BeamMP)

Notes:

• Players will automatically download required server-side mods/maps when joining.

• Use trusted, stable maps only—large or broken mods can cause crashes or long load times.

Step 1: Prepare the Custom Map

1. Download the map from a trusted source (e.g., official BeamNG Repository).

2. Confirm:

   • The map is a single .zip file

   • It is a level/map mod, not vehicle-only

3. Identify the internal map name:

   • Often matches the .zip filename

   • If unsure, extract it locally and check the folder inside:

      

     /levels/<map_name>/

You’ll need this name for the server config.

Step 2: Connect via FTP/SFTP

1. Log in to the ChicagoServers Control Panel:
   https://cp.chicagoservers.co

2. Open your BeamMP server

3. Locate your FTP/SFTP credentials

4. Connect using an FTP client (FileZilla, WinSCP, etc.)

If connection fails, verify:

• Correct IP/port

• Correct protocol (FTP vs SFTP)

• Username/password

Step 3: Upload the Map

1. Navigate to the server’s mod directory (commonly):

    

   Resources/Client

2. Upload the map as a .zip file

   • Do not extract it

3. Wait for the upload to fully complete

Step 4: Set the Default Map

Locate the Config File

Find your BeamMP server config file, such as:

• ServerConfig.toml

This is accessible via Configuration Files in the panel or through FTP.

Configure the Map

Use the internal map name (no .zip).

TOML example

Important:

• Do not include .zip

• Match capitalization if applicable

• Save the file after editing

Step 5: Restart the Server

1. Stop the server

2. Start it again from the control panel

3. Watch the console output for map-loading errors

If startup completes without errors, the map is active.

Step 6: Verify In-Game

1. Launch BeamMP

2. Join your server via:

   • Server browser, or

   • Direct connect (IP/port from panel)

3. Confirm the correct map loads

If not, re-check:

• Config key name

• Map name spelling

• Upload location

• Server restart

Common Issues & Fixes

Server Won’t Start

• Check console for map load errors

• Verify the map works in single-player BeamNG

• Temporarily switch back to a stock map (e.g., gridmap)

Players Stuck Loading

• Large maps cause long downloads or timeouts

• Test with fewer players first

• Avoid oversized or unoptimized maps

Map Didn’t Change

• Ensure you edited the correct config file

• Fully restart the server (not reload)

• Confirm the correct map key (DefaultMap, Map, etc.)

Best Practices

• Back up before changes using the ChicagoServers backup system

• Test maps locally first

• Use stable maps for public servers

• Re-test maps after BeamMP or BeamNG updates

Need Help?

When contacting support, include:

• Map filename (.zip)

• Configured map name

• Confirmation it works in single-player

• Any relevant console errors

This helps us quickly diagnose path, config, or map issues and get you online faster.