How to add mods to your BeamMP server

BeamMP sends mods to players automatically. You put the files in the right folder and everyone who joins downloads them.

1. Know the two folders

• Resources/Client holds mods that players need, such as vehicles and maps. These are sent to every player on join.
• Resources/Server holds Lua plugins that run on the server only. Players never download these.

2. Upload a vehicle or map mod

1. Stop the server in the Game Panel.
2. Download the mod as a .zip file. Do not unpack it. BeamMP expects the zip.
3. Open the Files tab and upload the zip into Resources/Client. Use SFTP for large maps.
4. Start the server and check the Console. Each mod is listed as it is loaded, with its size.

3. Use a modded map

1. Upload the map zip to Resources/Client as above.
2. Open ServerConfig.toml and set Map to the level path inside that mod, which normally looks like /levels/mapname/info.json.
3. Restart the server and watch the console for the map name.

The level folder name inside the zip is what matters, not the name of the zip file.

4. What your players see

• On joining, the launcher downloads every client mod before the game loads. The first join to a heavily modded server takes minutes.
• Players do not need to install anything by hand, and they should not, since a manual copy that differs from the server's causes mismatches.
• Removing a mod from the folder and restarting removes it from every player on their next join.

5. Keeping it manageable

• Every megabyte in Resources/Client is downloaded by every new player. A large mod pack turns into a long wait.
• Add mods a few at a time and restart in between, so you know which one broke a boot.
• Mods built for a much older BeamNG version can stop the map loading. Check the mod page for the version it supports.

If a mod is uploaded but never reaches players, confirm it is a zip and that it is directly inside Resources/Client, not in a subfolder.