Skip to main content

​
Exploring New Horizons

Running a derby event or a long-distance cruise requires the perfect map. Installing custom maps on your BeamMP server requires both physical file placement and a specific configuration string.
Reading TimeDifficultyLast Updated
5 minutesBeginnerJanuary 2026

​
Installation Steps

  1. Upload: Place your map .zip file into the /Resources/Client/ directory.
  2. Config Update: Open your ServerConfig.toml and update the Map variable. Example: Map = "/levels/derby_arena_v2/info.json"

​
Determining the Path String

If you are unsure what to type in the config:
  1. Open the map’s .zip file on your local PC.
  2. Navigate into the levels folder.
  3. The name of the folder inside levels is the identifier you must use.
  4. Format: /levels/[FOLDER_NAME]/info.json.

​
Troubleshooting Empty Voids

If players join and immediately spawn into a black or empty void, it indicates that the path string in your ServerConfig.toml is incorrect or contains a typo. Double-check that your path exactly matches the internal folder structure of the map zip.

​
Support Channels

If you need assistance or have any questions, please contact our support team:

​
First Month Discount

Use code KB20 at checkout to get 20% off your first month of hosting!
Last Updated: January 2026 | Maps: Boundless exploration.