October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk8 min

How to Change the Map on a BeamMP Server

A precise BeamMP map-change guide covering ServerConfig.toml, stock and custom level paths, ZIP placement, restart timing, and troubleshooting.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Stop the BeamMP server, open its ServerConfig.toml, change the Map value under [General], save the file, and restart the server. For a custom map, upload the map ZIP unchanged to Resources/Client and make the path match the level folder inside the ZIP exactly.

Most BeamMP configurations use a path such as /levels/<level-folder>/info.json. A few hosting examples use main.level.json instead, so the level-file convention supported by your host matters if an otherwise correct path fails.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What you need before changing the map

You need access to the machine or hosting panel that runs the BeamMP server, permission to stop and start that server, and a text editor that can save plain-text TOML files. The configuration file is normally in the same server directory as BeamMP-Server.exe and Server.log. Make a copy of the file before editing it so you can restore the previous setting if the server will not start or the selected level does not load.

  • Server access: You must be able to stop the process and edit its files. If a host provides a file manager, use that panel’s stop control before opening the file.
  • Configuration file: Locate ServerConfig.toml, not a similarly named backup or log file.
  • Map identifier: For a stock level, use its BeamNG level path. For a custom level, inspect the ZIP’s levels/ directory and copy the folder name exactly.
  • Maintenance window: Players are disconnected while the server restarts. One hosting guide describes the map transition as taking about 30 seconds; the actual duration depends on the host and server hardware.

Do not edit the file while the server is actively running. A running process can overwrite your changes, and players may remain connected to the old level until the next restart.

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.

Change a stock map step by step

  1. Stop the server. Use the host’s Stop button or stop the BeamMP server process on the machine. Wait until the process has exited before editing files.
  2. Open the server directory. Find the folder containing BeamMP-Server.exe, Server.log, and ServerConfig.toml.
  3. Back up the configuration. Copy ServerConfig.toml to a safe name such as ServerConfig.toml.backup. Keep the original extension on the working file so the server still recognizes it as TOML.
  4. Open the configuration in a plain-text editor. Search for the [General] section and its Map entry. TOML keys are case-sensitive in practice for this configuration, so edit the existing key rather than creating a second key with a different spelling.
  5. Replace only the map value. Keep the setting in quoted form. For example:
    Map = "/levels/west_coast_usa/info.json"
  6. Save the file. Confirm that the editor did not append an extra extension such as .txt. The filename must remain ServerConfig.toml.
  7. Start the server again. Use the normal Start control or launch command. The new level is selected during startup; connected players from the previous session must reconnect.

The official BeamMP documentation shows Map = "/levels/ks_nord/info.json" as a sample. That line demonstrates the format; it does not establish that ks_nord is the default map. Other guides show /levels/gridmap_v2/info.json as the default example.

Use the correct path for a built-in level

The path is not a display name such as “Italy” or “West Coast USA.” It is a level resource path beginning with /levels/, followed by the level’s directory name, and then the level’s entry file. Common examples documented by BeamMP guides are:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Level Example Map value Qualification
Gridmap /levels/gridmap_v2/info.json Shown as a default example by third-party guides; the official documentation sample does not state a default.
West Coast USA /levels/west_coast_usa/info.json Uses the standard info.json convention.
Italy /levels/italy/info.json Uses the standard convention in most guides.
East Coast USA Not stated in the supplied BeamMP guidance Do not guess a folder or filename; use the level’s actual resource path.
Nordschleife or another installed level Not stated unless your installation documents it Apply the same folder-and-entry-file pattern only when the path is confirmed.

Folder names, underscores, and capitalization must match the resource name. A path that looks almost right can still fail if one character differs.

Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

Why some guides show main.level.json

Most of the BeamMP instructions assembled for this procedure use info.json. An example from Cubes Hosting instead uses:

Map = "/levels/italy/main.level.json"

That is a real discrepancy, not two interchangeable spellings. If your host’s template or documentation uses main.level.json, follow that host-specific convention. If the server starts but rejects an info.json path, check the level files actually available in the server’s resources and the host’s expected entry file. Conversely, do not change a working info.json configuration solely because another provider uses a different example.

Verify that the new map loaded

After startup, verify the result from both the server side and the player’s side instead of assuming that a successful process launch means the requested map is active.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by
  1. Read the startup output. Check the server console or Server.log for map-loading errors, missing files, or a path that cannot be resolved.
  2. Join with a client. Confirm that the loading screen and the playable environment correspond to the level you selected.
  3. Check the exact configuration value. If the server loaded a different level, reopen ServerConfig.toml after stopping the process and make sure the saved value is the one you intended.
  4. Check file placement. A correct path cannot load a resource that is absent from the server’s available files or has been placed in the wrong resource directory.

Keep the previous configuration backup until players have successfully joined the new level. It gives you a known-good rollback if a later edit introduces a syntax or path error.

Set a custom map

Custom maps require two separate operations: place the map archive where BeamMP clients can receive it, then point the server’s Map key at the level folder contained in that archive.

Upload the ZIP without extracting it

  1. Stop the server before changing its resources.
  2. Open the server’s Resources/Client directory. This is the location identified by BeamMP hosting guidance for client-side map and mod ZIP files.
  3. Upload the map ZIP exactly as supplied. Do not unzip it unless the map’s own installation instructions explicitly require a different layout.
  4. Keep the archive’s filename and internal directory structure intact. Renaming the ZIP is less important than preserving the levels/ structure inside it, but leaving the archive unchanged makes troubleshooting easier.

Find the level folder inside the archive

Open a copy of the ZIP with an archive viewer and inspect the top-level levels/ directory. Suppose the archive contains:

Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

levels/desert_rally/info.json

The corresponding setting is:

Map = "/levels/desert_rally/info.json"

The folder name is desert_rally; it is not necessarily the ZIP filename, the map’s marketing name, or the name shown in a download page. Copy the internal folder spelling exactly, including underscores and capitalization. If the archive contains more than one level folder, select the one whose entry file is intended to launch the map and verify its installation notes.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Set the custom path and restart

Edit the Map key under [General] using the same procedure as for a stock map. The path must point to the level folder inside the uploaded archive, not to Resources/Client itself and not to the ZIP filename. Save the file and start the server again so it can load the new resource and advertise it to clients.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Fix “custom map not loading” problems

Use the symptom that you observe to narrow the cause. Change one thing at a time, and stop the server before each configuration edit.

Symptom Likely cause Check or fix
Server starts on the previous map The edited file was not the active ServerConfig.toml, the value was not saved, or the server was not restarted. Stop the process, confirm the file is in the directory containing the server executable, inspect the saved Map line, and start again.
Server reports a missing level or resource The folder name or entry filename does not match the archive. Open the ZIP, inspect levels/, and copy the internal path exactly. Pay special attention to underscores and capitalization.
Custom map is invisible to clients The ZIP is outside Resources/Client, was extracted into an unexpected extra directory, or was not uploaded at all. Place the original ZIP directly in Resources/Client, preserve its internal structure, and restart.
Clients disconnect during the change The server is restarting to apply the new map. Wait for startup to finish and reconnect. A guide describes this interruption as about 30 seconds, but timing varies.
info.json path fails while a host template uses another file Your provider may expect main.level.json or another documented entry file. Follow the host’s documented convention and inspect the level archive for the file it actually contains.
Server will not start after editing The TOML syntax was damaged, the quote marks are unbalanced, or the file was saved with an unintended extension. Restore the backup, start the server to confirm recovery, then make a single carefully quoted change.

TOML details that prevent avoidable errors

Only the value after Map = needs to change for a normal map switch. Preserve the section header and the surrounding configuration. A valid line has a quoted string and no smart quotation marks:

Map = "/levels/italy/info.json"

Do not add a second Map line elsewhere in the file to “override” the first one. Duplicate keys can produce an invalid or ambiguous configuration. Do not put the path in brackets, remove the leading slash, or replace the forward slashes with a Windows-style backslash path.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If you use a graphical editor, disable rich-text formatting. If you use a control-panel editor, verify that its Save action completed before restarting. A browser tab showing unsaved text is not evidence that the server will read those changes.

Plan the change for a live community server

A map switch is a restart operation, not a seamless in-game teleport. Announce the maintenance window, stop the server cleanly, make the edit, and allow enough time for startup and client reconnection. Since players are disconnected during the transition, schedule the change between sessions when possible.

  • Record the old Map value in your backup.
  • Record the new path and the reason for the change in your server notes.
  • Upload custom content before the announced restart so the maintenance window is spent applying the configuration rather than transferring files.
  • Keep the previous map available until at least one client has joined the new one successfully.
  • If the new map fails, stop the server, restore the known-good configuration, and restart rather than making several speculative edits at once.

Can the map be changed with an in-game command?

The documented procedure covered here is configuration editing followed by a server restart. The available material does not verify an official BeamMP chat or console command for changing maps while the server remains online, so do not rely on an unverified command for production operations. If a plugin or host panel offers a map-switch feature, treat it as a separate host- or plugin-specific function and confirm which configuration value it ultimately changes.

Quick reference

  1. Stop the BeamMP server.
  2. Back up and open ServerConfig.toml beside BeamMP-Server.exe and Server.log.
  3. Under [General], edit Map.
  4. For standard installations, use /levels/<name>/info.json and match the level folder exactly.
  5. For a custom map, upload the ZIP unchanged to Resources/Client and use the folder found inside its levels/ directory.
  6. Save, restart, inspect the log, and join to verify the result.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.