How to Add Custom Maps and Vehicle Mods to a BeamMP Server
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.
- Add mod .zip files (vehicles or maps) from the Mods tab, or upload them into
Resources/Clienton 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.jsonas 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
reloadmodson 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
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.
- 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/Clientand click Upload (or drag the files onto the page). - 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.
- Restart or reload
Click Restart at the top of the page, or type
reloadmodson the Console tab and press Send to reload everything in the Client folder. - 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:
/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.jsonBeamNG.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.
- Upload the map zip
Add the map's .zip from the Mods tab, or upload it into
Resources/Clienton the Files tab. - Find the level folder
Open the zip without extracting it. Inside there is a
levelsfolder containing a single folder. Note its name exactly, including case and underscores. - 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 - 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:
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 (
MaxCarsin 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. Usefalseto 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
| Symptom | Likely cause | Fix |
|---|---|---|
| Console warning that a file is not a ZIP and will be ignored | A non-zip file in Resources/Client | Remove 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 load | Wrong folder name in the map path | Re-read the folder under levels in the zip, or use getMissionFilename() in singleplayer |
| "done" or "start" message on join | A broken or incompatible mod | Remove mods one at a time to isolate it |
| Changes not showing up | Server not restarted, or the zip is in the wrong folder | Click Restart, or run reloadmods on the Console tab; confirm the zip is directly in Resources/Client |
| Map works for you but not others | A client-side mod conflict or an outdated game version | Have 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>.