How To Add Mods To Your BeamMP Server

Vehicle mods and custom maps both get added to your BeamMP server the same way: drop the file in your server's Resources/Client folder. Once it's there, the server automatically sends it to any player who joins, so nobody has to install anything manually.

Adding Vehicle Mods

Vehicle mods are the simplest kind to install.

1. Download the mod as a .zip file. Do not extract it.
2. Open the Files tab on your MintServers panel.
3. Navigate to the Resources/Client folder:
   📁 BeamMP-Server

   📁 Resources

   📁 Client (you are here)
4. Upload the .zip file directly into that folder.
5. Start your server.

That's it. The mod will now download automatically to every player the next time they connect.

Adding Custom Maps

Maps go in the exact same Resources/Client folder as vehicle mods, but you also need to point your server at the map afterward.

1. Download the map as a .zip file. Do not extract it.
2. Upload the .zip file to the same Resources/Client folder as a vehicle mod:
   📁 BeamMP-Server

   📁 Resources

   📁 Client

   📄 yourmap.zip (upload it here)
3. Open the zip file (without extracting it) and look inside the levels folder. There should be one folder inside with the map's internal name, for example myawesomedriftmap. Note this name exactly as written.
4. Open ServerConfig.toml and set the Map field to /levels/MAPNAME/info.json, replacing MAPNAME with the folder name from the last step:
   📁 BeamMP-Server

   📄 ServerConfig.toml (edit the Map field here)
5. Save and restart your server.

Players will now download the map automatically the first time they join.

If you just want one of BeamNG's default maps, you don't need to upload anything. Just set the Map field to one of the paths below:

• /levels/gridmap_v2/info.json — Grid Map
• /levels/west_coast_usa/info.json — West Coast USA
• /levels/east_coast_usa/info.json — East Coast USA
• /levels/italy/info.json — Italy
• /levels/utah/info.json — Utah
• /levels/jungle_rock_island/info.json — Jungle Rock Island
• /levels/industrial/info.json — Industrial Site
• /levels/small_island/info.json — Small Island
• /levels/driver_training/info.json — Driver Training
• /levels/hirochi_raceway/info.json — Hirochi Raceway
• /levels/johnson_valley/info.json — Johnson Valley

Keep Your Total Mod Size Sane

Every mod and map in Resources/Client gets downloaded by each player the first time they connect. The more you add, and the bigger those files are, the longer a new player waits before they can actually play.

• A handful of vehicle mods is barely noticeable. A folder full of detailed city maps and dozens of cars is not.
• Large, detail-heavy maps are usually the biggest offenders for both download size and RAM usage once loaded.
• Periodically clear out mods you're no longer using instead of letting the folder grow indefinitely.
• If your server is public, remember that a long first-join download is often enough to make a new player disconnect before it even finishes.

Troubleshooting

• Server won't start after changing the map: Double-check your Map path. A typo, or forgetting the trailing /info.json, is the most common cause.
• Players load into an empty void: The map zip is likely corrupted or incomplete. Re-download it and re-upload.
• Map takes forever to load: Large, detailed maps need more RAM. Make sure your plan has enough for the map you're running.
• Can't find the internal map name: If the zip's levels folder isn't clear, load the map in singleplayer, open the console with the tilde (~) key, and run print(getMissionFilename()) to get the exact path.

With mods and maps in place, your server should be ready for players to jump in without any extra setup on their end. If a mod refuses to cooperate, no worries! Just open a support ticket and our team will help you sort it out.