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 DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
World desk8 min

How to Install Custom Maps on a BeamMP Server

A complete BeamMP custom-map installation guide: where the ZIP goes, how to find the internal level name, how to set Map in ServerConfig.toml, and how to fix common loading failures.
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, copy the map’s compressed .zip archive into the server’s Resources/Client directory, leave it compressed, and point ServerConfig.toml to the map’s internal level path ending in /info.json. Restart the server so it loads the resource. For example, a map whose folder inside the archive is myawesomedriftmap2021 uses Map = "/levels/myawesomedriftmap2021/info.json".

The correct installation in one minute

BeamMP treats a downloaded map as a client resource (a server-delivered mod). The archive must be placed directly in the server’s client-resource folder:

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.

<server working directory>/Resources/Client/

Do not extract the archive, rename its internal folders, or use the ZIP filename in the map setting. Open the ZIP only to inspect it. Under its levels directory, find the map’s actual level folder and copy that name exactly. In ServerConfig.toml, set:

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

Restart BeamMP-Server after adding or replacing the ZIP. Client ZIP resources are loaded at startup; changing a file while the process is running does not reliably apply the change.

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

What you need before installing a map

  • A map mod packaged as a ZIP archive containing a levels directory. A download intended only for another game version or another mod loader may not work.
  • A BeamMP server that has been started at least once. The first launch creates ServerConfig.toml and the resource directories.
  • Access to the server’s working directory and permission to edit its TOML configuration.
  • A map compatible with the BeamNG.drive version on the connecting computers and with the installed BeamMP version.

The default configuration uses ResourceFolder = "Resources". If you changed that setting, use the corresponding resource-folder location instead of assuming the directory is beside the executable. The client subfolder is still named Client, so the target is the configured resource folder followed by /Client.

How a BeamMP map archive is organized

The name shown on a download page is not necessarily the name BeamNG uses internally. A typical archive has a structure similar to:

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.
map-download.zip
└── levels
    └── myawesomedriftmap2021
        └── info.json

The value required by the server is the path to info.json inside the archive: /levels/myawesomedriftmap2021/info.json. BeamMP resolves that virtual path after it loads the ZIP. It does not resolve a path based on map-download.zip.

Keep the archive intact. Extracting it into Resources/Client changes the resource layout BeamMP expects and is a common reason a map is ignored. Likewise, do not place the ZIP inside an extra folder such as Resources/Client/my-map/map.zip; the archive itself should be directly inside Client.

Step-by-step: install the custom map

1. Obtain and check the map ZIP

Download a BeamNG map mod from a source that permits server use and redistribution to players. Before copying it, verify that the archive contains a top-level levels directory. If it contains only vehicles, scenarios, or unrelated folders, it is not a complete level resource for the Map setting.

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.

Compatibility matters more than the file extension. A map built for a different BeamNG.drive release can fail even when the ZIP structure looks correct, and a map can conflict with another mod already installed on the server or clients.

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.

2. Copy the ZIP to the server

  1. Stop BeamMP-Server if you normally manage it as a service or terminal process. Stopping first prevents a restart from racing with a file copy.
  2. Open the server’s working directory and then the configured resource folder. With the default setting, open Resources/Client.
  3. Copy the map’s .zip file directly into that folder.
  4. Leave the file compressed. Do not unpack it, and do not put it in Resources/Server or a nested subdirectory.

BeamMP’s server manual describes Resources/Client as accepting ZIP resources. The map archive in that folder is what joining players receive; the server does not need a second copy in the game installation directory.

3. Read the internal level folder name

Use an archive viewer that can browse a ZIP without extracting it. Open levels and identify the folder immediately below it. Copy the folder name character for character, including capitalization, numbers, and underscores. For example, if the archive contains levels/myawesomedriftmap2021/, the internal name is myawesomedriftmap2021.

Do not infer this value from the download filename. A file called Awesome-Drift-Map-v3.zip can contain a level folder with a completely different name.

4. Edit ServerConfig.toml

Open ServerConfig.toml in a plain-text editor. Find the existing Map entry and replace only its value. The final line must have this form:

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

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

Keep the leading slash, use forward slashes, and include the /info.json suffix. The path is internal to the game resource; it is not a Windows path, Linux filesystem path, or ZIP filename. Save the TOML file without adding formatting characters or a second Map entry.

5. Restart BeamMP-Server

Start the server again after the ZIP and configuration are in place. BeamMP loads client ZIP resources when the server starts, so a live process will continue using its previous resource list until it is restarted.

Watch the console during startup and inspect Server.log for resource or map errors. Resolve an obvious load error before asking other players to test; otherwise their download attempt can obscure the original server-side problem.

6. Connect and confirm the download

Join the server from a client with the matching BeamNG.drive and BeamMP setup. BeamMP is designed to send the client resource to joining players automatically. The official setup guidance describes the expected result this way: “Now, when someone joins your server, it should download the map automatically and work as expected.”

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

For a same-computer test, use BeamMP Direct Connect to 127.0.0.1 and the port configured for the server. This isolates map installation from public-server discovery and lets you inspect the server console while connecting.

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.

What belongs in the Map setting?

The Map value is a virtual level path. It points to the level’s internal info.json, not to the archive on disk. Stock maps and custom maps use the same path format, but only custom maps require a ZIP in Resources/Client.

Map type Example Map value Upload required?
Stock grid map /levels/gridmap_v2/info.json No
Stock Italy map /levels/italy/info.json No
Stock Utah map /levels/utah/info.json No
Stock West Coast USA map /levels/west_coast_usa/info.json No
Custom map /levels/<folder-inside-ZIP>/info.json Yes, in Resources/Client

For a stock level, select its existing path directly. For a modded level, BeamMP must have the corresponding ZIP before that path can resolve.

How to choose a map that will work on a server

Installation mechanics are identical across maps, but the practical server experience differs. Check these factors before deploying a large archive:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Factor What to check Why it matters
Version compatibility The map’s supported BeamNG.drive release and your BeamMP server/client versions Outdated map files can produce loading errors or broken gameplay.
Archive structure A levels directory and a valid info.json beneath the level folder Without the expected structure, the Map path cannot resolve.
Download size The ZIP’s file size and how often players will need to download it Large maps increase join time and bandwidth consumption.
Gameplay style Racing, free-roam, roleplay, or another layout suited to your server The map should match how players actually use the server.
License and redistribution Whether the creator permits server hosting and automatic distribution Permission may be required before sending the archive to every joining player.
Mod interactions Known conflicts with vehicles, scripts, or other maps already installed One incompatible resource can prevent a session from loading correctly.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshooting a custom map that does not load

The server starts, but the map never appears

  • Confirm the ZIP is directly inside Resources/Client, not inside another directory.
  • Confirm the archive is still compressed. Remove an extracted copy and restore the original ZIP.
  • Check that ResourceFolder in ServerConfig.toml points to the folder you are actually using.
  • Restart BeamMP-Server after every resource replacement; startup is when client ZIPs are loaded.

The Map line looks right, but the level name is wrong

Reopen the archive and inspect the directory under levels. Copy that folder name exactly rather than copying the download title. A single missing underscore, changed letter, or incorrect case can point to a path that does not exist. The final setting must still end in /info.json.

You cannot determine the correct internal path

Install the map in single-player BeamNG.drive first and launch it successfully. Open the in-game system console with ~ (or the key bound to your console) and run:

print(getMissionFilename())

The returned mission filename reveals the path BeamNG is using. Use that returned path in the server’s Map setting, retaining the level path and info.json target required by BeamMP.

Players receive a join error after the map was added

BeamMP warns that mods can be incompatible with BeamNG, with BeamMP, or with one another. Temporarily remove the newly added map and any other recently installed resources, restart the server, and test again. If the server works without them, reintroduce resources one at a time until the conflicting archive is identified. Also verify that the joining client can run the map in single-player; a server cannot repair a map that fails locally.

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

Some players cannot finish the download

Check the archive size, server connectivity, and whether the map is licensed for redistribution. Have a player remove an incomplete local copy and reconnect so BeamMP can request the resource again. If only one player is affected while others download successfully, compare that client’s BeamNG.drive and BeamMP versions before changing the server configuration.

Protected maps and restricted content

Some creators restrict how a mod is distributed. BeamMP documents a protectmod command for protected resources. Protection does not give players access by itself: players must obtain the protected file from the creator or another authorized source and place it in their launcher resources folder. Do not bypass a creator’s distribution controls or upload a protected file without permission.

Safe replacement and update procedure

When replacing a map with a newer archive, treat the change as a resource update rather than simply overwriting a file while the server runs:

  1. Stop the server.
  2. Back up the current ZIP and the existing Map line.
  3. Remove the old archive from Resources/Client and copy in the replacement ZIP.
  4. Inspect the replacement archive’s levels folder. Its internal name may have changed even when the download’s public name did not.
  5. Update Map to the new internal path if necessary.
  6. Start the server and inspect the console or Server.log before reconnecting players.

Keeping a backup lets you restore the previous archive and path if the update introduces a compatibility or mod-conflict problem.

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

Final pre-join check

  • The archive is a compatible BeamNG map ZIP and contains levels.
  • The ZIP is directly in the configured Resources/Client directory and remains compressed.
  • The folder name under levels was copied exactly.
  • Map uses /levels/<exact-folder>/info.json, not the ZIP filename.
  • The server was restarted after the resource or configuration changed.
  • Startup output and Server.log show no map-loading error.
  • The map works in single-player, and the server’s BeamNG.drive/BeamMP versions are compatible with it.

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 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
Windows Errors? Fix Them Before They SpreadFree repair 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.