Welcome to ChicagoServers

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.