DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober 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 PC×
Skip to content
VGSources
Blog

How to Change the Map on a BeamMP Server

Stop the server, edit the Map value under [General] in ServerConfig.toml, and restart. This guide covers stock paths, custom map ZIPs, the info.json versus main.level.json discrepancy, and fixes for maps that fail to load.
Length9 min Posted Quest giverVGSources Team

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.

To change a BeamMP server’s map, stop the server, edit the Map entry in ServerConfig.toml under [General], save the file, and restart the server. Stock maps normally use a path such as /levels/gridmap_v2/info.json. For a custom map, upload its ZIP unchanged to Resources/Client, then set Map to the exact folder name inside the ZIP’s levels/ directory.

The quick procedure

The setting is read when the BeamMP server starts, so changing the file while the process is running is not enough. Use this order:

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.
  1. Stop the BeamMP server cleanly.
  2. Open the server’s ServerConfig.toml file.
  3. Find the [General] section and edit its Map value.
  4. Enter the level path in the form /levels/<name>/info.json, replacing <name> with the level folder name.
  5. Save the file and start the server again.
  6. Join the server and confirm that the intended level loads.

A map change usually disconnects current players while the server restarts. One hosting guide estimates the interruption at about 30 seconds, but the actual time depends on the host and the map.

What you need before editing

  • Access to the machine or hosting control panel that contains the BeamMP server files.
  • Permission to stop and start the server.
  • A text editor that does not add rich-text formatting to TOML files.
  • The exact level path for the map you want to load.

Stop the server before opening the configuration for editing. This prevents the running process from keeping an old value in memory or rewriting the file when it shuts down. If the server is public, warn players first: everyone currently connected will be removed during the restart.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

Make a copy of ServerConfig.toml before changing it. A backup lets you restore the previous map if the new path is rejected. Keep the backup outside the server’s active configuration location so the server does not mistake it for the live file.

Where the map setting lives

The official BeamMP documentation identifies ServerConfig.toml as the configuration file in the server folder, alongside files such as Server.log and BeamMP-Server.exe. Open that file and look in the [General] section.

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

The setting has this shape:

[General]
Map = "/levels/gridmap_v2/info.json"

The quoted path above is an example. The official documentation also shows /levels/ks_nord/info.json as a sample value; that sample should not be treated as a guaranteed default for every installation.

Change only the value after Map =. Keep the key name, equals sign, quotation marks and TOML section heading intact. Do not add a Windows drive letter, a server URL or the path to the ZIP file itself.

Choosing a stock BeamNG level

Stock levels use the level directory and a level metadata file. The common pattern documented by BeamMP guides is /levels/<level-folder>/info.json. These examples illustrate the format:

Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed
Level Map value What to check
Gridmap /levels/gridmap_v2/info.json The folder name contains an underscore and must be copied exactly.
West Coast USA /levels/west_coast_usa/info.json Use the folder spelling shown by the installed level files.
Italy /levels/italy/info.json Some hosts document a different level file; see the compatibility note below.
Official documentation sample /levels/ks_nord/info.json This demonstrates syntax and is not stated as a universal default.

Use the folder name, not the display name shown in a launcher or server browser. A display name can contain spaces while the filesystem folder uses underscores or another spelling. The path is also case-sensitive on systems that enforce case-sensitive filenames, so preserve capital letters exactly when they appear.

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

The info.json and main.level.json discrepancy

Most BeamMP instructions use an info.json path. A separate hosting guide gives Map = "/levels/italy/main.level.json" for Italy instead. Those two conventions conflict, and the available documentation does not establish one universal rule for every host or server package.

If the standard info.json path fails, inspect the installed level’s levels/italy/ directory and check the file names your host expects. On a managed host, use the provider’s current map example for that server image. Do not append main.level.json to every map automatically; use it only when the files or host instructions indicate that this is the required entry point.

Changing the map on a self-hosted server

1. Stop the process

Use the server’s normal stop control, service manager or hosting panel. Wait until the BeamMP process has exited before editing. If a console window remains open, confirm that it no longer reports the server as running.

2. Open the correct configuration file

Navigate to the folder that contains the BeamMP server executable and log. Open ServerConfig.toml in a plain-text editor. If you see several copies, use the one in the active server folder—the folder whose log updates when you start the server.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

3. Edit the Map line

Under [General], replace only the existing map path. For example, to use West Coast USA:

[General]
Map = "/levels/west_coast_usa/info.json"

For Gridmap, the value would be /levels/gridmap_v2/info.json. Keep the leading slash and the /levels/ directory. A path such as west_coast_usa without those components is not the documented format.

4. Save as TOML

Save the file without changing its name or extension. A text editor that silently creates ServerConfig.toml.txt will leave the real configuration untouched. Check the filename in the file manager after saving.

5. Start the server

Launch the same server instance you stopped. Watch the console or Server.log for startup errors. Once the server is available, connect with a client and verify the level. If the old map still appears, the most likely causes are an edited copy of the file, an unsaved change, or a second server instance using another folder.

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

Loading a custom map

Custom maps require two separate actions: installing the map archive where clients can receive it, and pointing the server’s Map key at the correct level metadata file.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

1. Keep the map as a ZIP archive

Place the custom map ZIP in the server’s Resources/Client folder. The hosting guidance for this workflow says to upload mod ZIPs as-is rather than unzipping them. Do not rename internal folders to make them look nicer, and do not place the archive in an unrelated server directory.

2. Inspect the archive structure

Open a copy of the ZIP with an archive utility and look for its levels/ directory. Identify the folder immediately below it. For example, if the archive contains levels/my_desert_track/info.json, the level folder name is my_desert_track.

The archive may contain other files, but the name directly under levels/ is the part that determines the map path. Do not use the ZIP filename unless it exactly matches that internal folder.

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.

3. Match the folder name exactly

Set the configuration to the internal name, preserving every underscore, hyphen and capital letter:

[General]
Map = "/levels/my_desert_track/info.json"

If the archive uses a capitalized folder such as MyDesertTrack, use /levels/MyDesertTrack/info.json. A one-character difference can make the server fail to find the level.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

4. Restart after both changes

Stop the server, save the configuration, and start it again after uploading the ZIP. The server must restart with the new Map value; uploading the archive alone does not select it.

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

Using a hosting control panel

Managed hosts generally expose the same files through a web file manager, SFTP or an editor labeled “ServerConfig.toml.” The labels differ, but the sequence does not:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Press the panel’s stop button and wait for the status to show that the server is offline.
  2. Open the file manager and locate ServerConfig.toml in the server root.
  3. Edit the Map entry under [General].
  4. For a custom map, upload the ZIP to Resources/Client without extracting it.
  5. Save the file, close the editor, and start the server.

Some panels provide a map selector that writes the same configuration value for you. If the selector and the file disagree, the value that the active server reads at startup determines the result. After using a panel selector, reopen the file and verify the resulting path rather than assuming the display label maps to the intended level.

Troubleshooting a map that will not load

Symptom Likely cause Action
The old map still loads The wrong file was edited, or the server was not restarted. Stop the active instance, confirm its folder from the updated log, check the saved Map line, and start it again.
Server startup reports an invalid map The path is misspelled or uses the wrong entry file. Compare the path with the installed levels/ folder. Try the host’s documented info.json or main.level.json convention for that level.
A custom map is missing The ZIP is in the wrong directory or was extracted incorrectly. Put the original ZIP in Resources/Client, then restart.
The custom map archive is present but still fails The Map value does not match the internal folder name. Inspect the ZIP’s levels/ directory and copy the folder name exactly, including case and underscores.
Players can join but are disconnected during a change The server is restarting to apply the new map. Wait for startup to complete and reconnect after the server is online.
The configuration appears unchanged after saving The editor added a second extension or failed to write permissions. Confirm the filename is exactly ServerConfig.toml, reopen it as plain text, and verify the timestamp and contents.

Check the log before changing multiple settings

Use Server.log to determine whether the failure is a path problem, a configuration parse problem or a missing resource. Change one item at a time. Editing unrelated settings while diagnosing a map makes it harder to identify which change caused the failure.

Validate the directory level by level

For a stock map, confirm that the level folder exists beneath the game’s available levels and that the referenced metadata file is present. For a custom map, confirm all of the following in order: the ZIP is in Resources/Client; the archive contains levels/; the expected folder is directly beneath it; and the file named in Map exists inside that folder.

Planning a map change for players

A map change is a server restart, not a seamless rotation. Announce the maintenance window, stop new sessions if your host offers that control, and give connected players time to leave. Because one guide reports roughly 30 seconds of disconnection during the change, schedule it between events rather than in the middle of a race or convoy. Treat that figure as an estimate, not a guaranteed service time.

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

Keep the previous working value until the new level has been tested. If the new map fails, restore the backup, start the server, and only then investigate the custom archive or alternate level filename. This rollback is faster than trying several unverified paths on a live server.

Common configuration mistakes to avoid

  • Editing ServerConfig.toml while the server is still running and assuming the process will reload it.
  • Using the ZIP filename instead of the folder name inside levels/.
  • Removing the leading slash or the /levels/ portion of the path.
  • Changing capitalization or replacing underscores with spaces.
  • Extracting a custom map when the host instructions require the ZIP to remain intact.
  • Assuming the ks_nord or gridmap_v2 examples are universal defaults.
  • Applying the Italy main.level.json example to maps that expect info.json.
  • Editing several server settings at once, which obscures the cause of a failed startup.

Recommended verification checklist

  • The server process is stopped before editing.
  • The file is the active server’s ServerConfig.toml.
  • Map is under [General].
  • The path starts with /levels/.
  • The folder name matches the installed level exactly.
  • The referenced metadata filename exists for that level.
  • Custom ZIP files are in Resources/Client and remain unextracted when required by the host.
  • The file was saved with the exact .toml extension.
  • The server was restarted and the log was checked.
  • Players were warned about the temporary disconnect.

What is established about map selection

The dependable configuration method is to edit Map and restart. The official documentation identifies the configuration file and shows the /levels/.../info.json style, while hosting guides provide additional stock examples and the custom-map placement procedure. Exact defaults for every server release and host are not established by the available documentation, so treat examples as paths to verify against the files installed on your server.

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.

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 quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

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.