We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a BeamMP server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!
BeamMP guide

How to Add Custom Maps and Vehicle Mods to a BeamMP Server

By the ChicagoServers team · Updated · 6 min read

Vehicle mods and map mods both go in the same place: zip files in your server's Resources/Client folder. Players download them automatically when they join. On ChicagoServers you install them from the Mods tab or upload the zips on the Files tab. A custom map also needs one extra step: setting the map on the Startup tab to point at the right /levels/.../info.json path.

Below is the full process, the stock map paths, how to find a custom map's path when it does not load, and what to watch for on download size and game version. Details were checked against the official BeamMP docs and the v3.9.3 server on 2026-11-01.

Quick answer
  • Add mod .zip files (vehicles or maps) from the Mods tab, or upload them into Resources/Client on the Files tab. Only .zip files are served to players; other files are skipped with a warning.
  • For a custom map, open the zip without extracting it, find the single folder inside levels, and use /levels/FOLDERNAME/info.json as the map: Map from a mod on the Startup tab.
  • Stock maps need no files: pick one in the Map field on the Startup tab.
  • After changing the map, click Save startup and Restart. If you only added mods, type reloadmods on the Console tab to reload the Client folder.
  • Players download everything from your server when they join, so a long mod list means a slow first join.
On this page
  1. Where mods and maps go: Resources/Client
  2. How to change the map on a BeamMP server
  3. How to install a custom map and find its path
  4. Adding vehicle mods
  5. Download size, join times and BeamNG version compatibility
  6. Troubleshooting maps and mods
  7. Frequently asked questions

Where mods and maps go: Resources/Client

The server creates a Resources folder on first run. Inside it, Client holds everything players must have, and Server holds server-side Lua plugins (covered in our Lua plugins and moderation guide). Both vehicle mods and map mods are just zip files dropped into Client.

  1. Add the mods

    Open your server in the panel. Use the Mods tab to install, update and remove mods. To add a zip yourself, open the Files tab, go to Resources/Client and click Upload (or drag the files onto the page).

  2. Keep the zips as they are

    Upload each mod as a .zip without extracting it, exactly as downloaded from the mod page. Do not use Extract here on it. For many or very large files, use SFTP: copy Host, Port and Username from the blue SFTP bar.

  3. Restart or reload

    Click Restart at the top of the page, or type reloadmods on the Console tab and press Send to reload everything in the Client folder.

  4. Join and test

    Join from a game client and confirm the content downloads and loads.

How to change the map on a BeamMP server

The map setting takes a level path. For the stock maps no installation is needed, you only change the path. On ChicagoServers, open the Startup tab, choose the map in Map (or Map from a mod for a custom map; where the field offers Other (type it in)… you can type a path), click Save startup, then Restart. These are the stock paths listed in the BeamMP docs:

Stock map paths from the BeamMP docs
/levels/gridmap_v2/info.json          (server default)
/levels/johnson_valley/info.json
/levels/automation_test_track/info.json
/levels/east_coast_usa/info.json
/levels/west_coast_usa/info.json
/levels/hirochi_raceway/info.json
/levels/italy/info.json
/levels/jungle_rock_island/info.json
/levels/industrial/info.json
/levels/small_island/info.json
/levels/smallgrid/info.json
/levels/utah/info.json
/levels/driver_training/info.json
/levels/derby/info.json

BeamNG.drive adds and renames content over time, so if a stock path from this list stops loading after a game update, compare it with the current BeamMP docs. The value must be a stock map or a map installed as a server mod, and the backend caps the setting at 100 characters.

How to install a custom map and find its path

A custom map is a zip in Resources/Client plus the right Map value. The path is built from the folder name inside the zip.

  1. Upload the map zip

    Add the map's .zip from the Mods tab, or upload it into Resources/Client on the Files tab.

  2. Find the level folder

    Open the zip without extracting it. Inside there is a levels folder containing a single folder. Note its name exactly, including case and underscores.

  3. Set the map

    On the Startup tab, choose your map in Map from a mod. If you need to enter the path by hand, build it from the folder name, ending in /info.json, and use Other (type it in)… where the field offers it. Then click Save startup.

    /levels/myawesomedriftmap2021/info.json
  4. Restart the server

    Click Restart and watch the Console tab for errors before joining.

If the map does not load, the folder name is usually the problem. The BeamMP docs give a reliable fallback: install the map in singleplayer BeamNG.drive, open it, open the in-game console (the ~ key by default) and run:

BeamNG.drive console
print(getMissionFilename())

That prints the path the game itself uses for the level, which is what the server's Map setting needs.

Adding vehicle mods

Vehicle mods follow the same rule: .zip into Resources/Client (from the Mods tab or the Files tab), restart or reloadmods, done. There is no list to maintain in the map or mod settings. Whatever zips are in the folder get sent to joining players.

  • Start small. Add mods in batches. If players report a "done" or "start" message when joining after you add mods, one of them is broken or incompatible. Remove mods one at a time until it joins cleanly.
  • Limit cars to limit load. Cars per player on the Startup tab (MaxCars in ServerConfig.toml) caps vehicles per player, which matters more once heavy modded vehicles are available.
  • Paid or private mods: the console command protectmod FILENAME.zip true (type it on the Console tab) marks a mod as protected. Players then have to obtain that file themselves and place it in their BeamMP launcher's resources folder, since the server will not hand it out. Use false to undo it.

Download size, join times and BeamNG version compatibility

The BeamMP docs do not set a file size limit for mods, but the practical limit is how long a new player will wait. The server you join provides the mods, which are downloaded and activated automatically on connect, and the launcher caches them afterwards. That means:

  • The first join is the slow one. Because the launcher caches downloaded mods, repeat joins are faster.
  • A server with a lot of large mods works against itself, because many players will give up during the download. Keep the set to what the server's identity actually needs.
  • The files come from your server, so its upload bandwidth matters when several players join at once. BeamMP's own minimum guidance for a server is 5 to 10 Mb/s of upload.

Version compatibility is the other half. BeamMP states it does not work with outdated versions of BeamNG.drive, and mods are built against a particular game version. A mod that worked last season can break after a BeamNG update. Before adding a mod, check its page for the BeamNG.drive version it targets, test it in singleplayer on the version your players run, and check the BeamMP announcements after each BeamNG update to see whether the multiplayer mod and the server have been updated for it.

If your home upload speed is the bottleneck for joins, that is one common reason communities move to BeamMP server hosting.

Troubleshooting maps and mods

SymptomLikely causeFix
Console warning that a file is not a ZIP and will be ignoredA non-zip file in Resources/ClientRemove everything that is not a .zip on the Files tab (the mods.json the server creates can stay)
Players load into the wrong map or fail to loadWrong folder name in the map pathRe-read the folder under levels in the zip, or use getMissionFilename() in singleplayer
"done" or "start" message on joinA broken or incompatible modRemove mods one at a time to isolate it
Changes not showing upServer not restarted, or the zip is in the wrong folderClick Restart, or run reloadmods on the Console tab; confirm the zip is directly in Resources/Client
Map works for you but not othersA client-side mod conflict or an outdated game versionHave the player clear cached mods and update BeamNG.drive and BeamMP

Frequently asked questions

Where do I put BeamMP map and mod files?

In the Resources/Client folder of your server, as .zip files. Both vehicle mods and map mods go there, and players download them automatically when they join. Use the <strong>Mods</strong> tab, or open the <strong>Files</strong> tab and click <strong>Upload</strong> in that folder.

How do I find the right Map path for a custom map?

Open the map's zip, look inside the levels folder for the single folder it contains, and use /levels/FOLDERNAME/info.json. If it still does not load, run print(getMissionFilename()) in the BeamNG.drive console with the map open in singleplayer.

Is there a limit on mod size?

The BeamMP docs do not state a size limit. The practical limit is how long players will wait to download the files from your server on their first join, so keep the mod list focused.

Do I need to restart the server after adding a mod?

Restarting is the safe choice. The <strong>Console</strong> tab also accepts a reloadmods command that reloads everything in Resources/Client without a full restart, but changing the map needs <strong>Save startup</strong> and a <strong>Restart</strong>.

We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a BeamMP server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

We offer quality support, a detailed knowledgebase, video tutorials on most topics, and even live support in case you prefer a live human.

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!