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 Install Custom Maps on a BeamMP Server

A complete BeamMP custom-map guide covering ZIP placement, internal level paths, ServerConfig.toml syntax, restarts, local testing and compatibility troubleshooting.
Length9 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To install a custom map on a BeamMP server, place the map’s compressed .zip archive directly in Resources/Client, leave it compressed, then point ServerConfig.toml at the map’s internal level folder and info.json. For example: Map = "/levels/myawesomedriftmap2021/info.json". Restart the server so it loads the archive; joining players should then download the map automatically.

What you need before installing a map

A BeamMP server creates its configuration file and resource directories during the first launch. The normal layout uses a server working directory containing ServerConfig.toml and a Resources directory. Inside that directory, Resources/Client is the location for client-side resource archives such as map mods.

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.
  • A map mod distributed as a ZIP archive.
  • A BeamNG.drive and BeamMP version combination supported by that map.
  • Access to the BeamMP server’s working directory and permission to edit its TOML configuration.
  • An archive viewer capable of opening a ZIP without extracting it.

The example server configuration uses ResourceFolder = "Resources". If you changed that setting, use the corresponding resource-folder location; the required Client subdirectory is relative to the configured resource folder, not necessarily the default path.

How BeamMP finds a custom map

BeamMP does not use the downloaded filename as the map identifier. It reads the archive’s internal levels directory and loads the level folder named in the Map setting. That setting must identify the level’s info.json file.

#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.

A typical archive has a structure similar to this:

my-map-download.zip
└── levels
    └── myawesomedriftmap2021
        ├── info.json
        ├── main.level.json
        └── ...

For that structure, the correct configuration value is:

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

The spelling, capitalization and underscores in the level folder must match exactly. The ZIP filename can be different; only the folder below levels matters.

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

Step-by-step installation

1. Obtain a compatible map ZIP

Use a BeamNG map mod that contains a levels directory and is intended to work with the BeamNG.drive and BeamMP versions on your server. A map that works in a newer game build may fail on an older installation, and a map can also conflict with another server mod even when both work individually.

2. Stop the server before changing files

Shut down BeamMP-Server cleanly before copying or replacing resources. This prevents a file from being changed while the server is reading it and gives you a clear startup log after the installation.

3. Copy the archive to the client resource directory

Place the map archive directly in:

<server working directory>/Resources/Client/

Keep the file as a .zip. Do not extract it into a folder, and do not put it inside an extra subdirectory such as Resources/Client/MyMap/. BeamMP’s client resource directory accepts ZIP files and loads them when the server starts.

4. Inspect the ZIP and copy the internal level name

Open the archive with an archive manager while leaving it compressed. Open its levels directory and copy the exact name of the map folder inside it. Do not infer this name from the download title: authors often use a different internal identifier, include underscores, or retain a development suffix.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
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

If the archive contains several unrelated top-level folders, inspect the layout carefully. The value you need is the folder that directly contains the level’s info.json, expressed beneath /levels/.

5. Edit ServerConfig.toml

Open ServerConfig.toml in a plain-text editor. Replace the existing map value with the internal path and retain the leading slash and the /info.json suffix:

Map = "/levels/<exact-folder-name>/info.json"

For the example archive above, the complete line is:

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

Keep the TOML syntax intact: use a quoted string, do not add a ZIP filename, and do not point to a directory. Save the file in the server’s working directory.

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.

6. Start BeamMP-Server and read the startup output

Start the server again. Resource archives are loaded during startup, so a running process will not notice a newly copied or replaced client ZIP until it is restarted. Watch the console or Server.log for errors before inviting players.

7. Join and verify the download

Connect with a client that has the same BeamMP and BeamNG.drive compatibility baseline. BeamMP should send the map to a joining player automatically. If the server and game are on the same computer, use BeamMP Direct Connect to 127.0.0.1 and the port configured for the server to perform a local check first.

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)

“Now, when someone joins your server, it should download the map automatically and work as expected.” — BeamMP Docs, Server Setup guide

Choosing the correct Map value

Situation What belongs in Map Server file action
BeamNG stock level The stock level path ending in /info.json No upload to Resources/Client is required.
Downloaded custom map /levels/<internal-level-folder>/info.json Keep the map ZIP directly in Resources/Client.
Edited or private map packaged as a mod The exact internal path inside the edited ZIP Use the packaged ZIP as the server resource and confirm redistribution rights.

BeamMP’s maintenance reference gives these examples for stock content: /levels/gridmap_v2/info.json, /levels/italy/info.json, /levels/utah/info.json and /levels/west_coast_usa/info.json. Stock levels are already part of the game installation, whereas a downloaded or edited level must be available to clients through Resources/Client.

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

How to verify an archive before putting it online

A few minutes of inspection avoids most path errors. Check the following in order:

  1. Confirm the file extension is .zip, not a folder renamed to look like a ZIP.
  2. Open the archive and locate levels.
  3. Open the level folder below levels and verify that info.json is present at that level.
  4. Copy the folder name exactly, preserving every character and underscore.
  5. Make sure the archive itself, rather than an extracted copy, is directly under Resources/Client.
  6. Use the resulting path in ServerConfig.toml and check that it ends in /info.json.

The download filename, screenshots, map title and the name shown on a mod page are not reliable substitutes for the internal folder name.

Testing a map locally before asking others to join

If the correct internal path is unclear, install the map in single-player BeamNG.drive first. Launch the map, open the game’s system console with ~ (or whichever key is assigned to the console), and run:

print(getMissionFilename())

The returned mission filename identifies the path BeamNG is using for the loaded level. Use that returned path as the value after Map =, retaining the required quoted TOML syntax. This is particularly useful when a mod archive contains an unexpected folder name or a nested level layout.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
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

A local Direct Connect test also separates server configuration problems from public-network problems. Connect to 127.0.0.1 on the configured port, wait for the resource download, load into the map and drive long enough to confirm that terrain, objects and scripts appear normally.

Troubleshooting a custom map that will not load

The server starts, but the map never appears

  • Check that the ZIP is directly inside Resources/Client, not inside another folder.
  • Confirm that the archive was not extracted. The client resource directory is intended for ZIP resources.
  • Open the archive again and verify that a levels directory and the referenced level folder exist.
  • Compare the Map value character by character with the internal folder name.
  • Make sure the value ends in /info.json and does not end at the folder level or include the archive filename.

The level name looks right, but the path is still rejected

Use the single-player console command print(getMissionFilename()) described above. The returned path is more authoritative than the download name or a readme example. Copy it without changing its directory names, then restart the server after saving the configuration.

Players receive a join error after the map was added

BeamMP warns that mods can be incompatible with BeamNG, BeamMP or one another. Temporarily remove the new map and any other recently added mods, restart the server, and test the map by itself. If it works alone, add the other resources back one at a time to identify the conflict. Also verify that the clients and server are running compatible game and BeamMP versions.

The server behaves as though the old map is still installed

Client ZIP resources are read at server startup. Stop and restart BeamMP-Server after adding, replacing or removing a map archive, then inspect the new startup output and Server.log. Editing the ZIP or TOML while the process remains online does not reload the resource.

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

The download succeeds but the game fails while loading

First test the same map in single-player BeamNG.drive. A failure there indicates a map or game-version problem rather than a BeamMP transport problem. If single-player works, isolate other server mods, check the exact mission filename, and repeat the local Direct Connect test with only the map installed.

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

Map compatibility, download size and permissions

Before selecting a map for a public server, evaluate more than its appearance. The practical comparison points are:

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.
Factor Why it matters What to verify
BeamNG.drive and BeamMP compatibility A map built for another game or networking version may fail to load or behave incorrectly. Supported versions stated by the map author and your installed server/client versions.
Archive structure The server needs a usable levels path and an info.json target. Open the ZIP and confirm the internal folder before editing Map.
File size Every joining player must download the client resource, so a large archive increases waiting time and bandwidth demand. The ZIP size and the connection capacity available to your players.
Gameplay style A circuit, freeroam environment and roleplay map impose different expectations and server rules. Whether the layout supports the activities your community actually runs.
Licensing and redistribution Hosting a file for automatic download may be restricted by its creator. Read the map’s license and sharing terms before placing it on a public server.
Mod interaction Another resource can overwrite files or introduce an incompatibility. Test the map alone, then reintroduce other mods gradually.

Do not redistribute protected content unless you are authorized to do so. BeamMP documents a protectmod command for restricted mods. When a protected file is used, players must obtain the file from its creator or another authorized source and place it in their launcher resources folder; automatic public delivery is not a substitute for that permission.

Replacing, removing or switching maps

Replacing a map archive

Stop the server, replace the old ZIP in Resources/Client with the new archive, inspect the new archive’s internal level name, update Map if that name changed, and start the server. Treat a replacement as a new compatibility test even when the download filename is unchanged.

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

Removing a custom map

Stop the server before deleting the ZIP. Change Map to a valid stock level or another custom level that remains installed, then start the server and verify the selected level locally. Leaving a removed level in the configuration produces a path failure because the referenced info.json is no longer available.

Switching between several installed maps

You may keep multiple compatible ZIP archives in Resources/Client, but Map selects one level at a time. To switch, edit only the path to the desired internal info.json, save the TOML file and restart the server so the selection is applied.

Operational checklist

  • Map archive is a compatible ZIP.
  • ZIP is directly in Resources/Client.
  • Archive remains compressed.
  • levels and the intended level folder are present.
  • info.json exists at the referenced level path.
  • ServerConfig.toml uses the exact internal folder name.
  • Map begins with /levels/ and ends with /info.json.
  • Server was restarted after the resource or configuration change.
  • Startup console and Server.log show no map-loading errors.
  • A local Direct Connect test succeeds before public players are invited.
  • Map licensing permits the intended redistribution.

Frequently overlooked details

The most common mistake is treating the ZIP filename as the map path. BeamMP follows the level folder inside levels, so a file named awesome_drift_v4.zip can legitimately require a different identifier. The second is extracting the archive: extraction changes the layout BeamMP expects in Resources/Client. The third is forgetting the restart; client resources are loaded at startup, not continuously while the server is running.

Once the archive location, internal folder name and info.json path agree, the installation is complete. Players joining afterward can receive the map through BeamMP’s normal client-resource download process.

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

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 *

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.

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
Outdated Drivers Are Slowing You DownFree scan - exact matches

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.