How to Add Mods to Your BeamMP Server

This article covers adding mods to your BeamMP server, such as vehicles, vehicle configs, and parts. These mods are downloaded automatically by anyone who joins your server, so you only need to install them once on the server.

If you want to add a custom map, see the separate custom maps article. Maps are installed in the same folder but are pointed to differently.

Where mods go

BeamMP has two mod folders inside your server's Resources directory:

• Resources/Client holds client-side mods: vehicles, configs, parts, and maps. These are sent to players automatically when they join. This is the folder you will use most of the time.
• Resources/Server holds server-side Lua plugins. These run on the server only and are not downloaded by players. Most people do not need this folder so please read the map/mod instructions before use.

For normal mods, you want Resources/Client, found in the Files tab.

Adding a vehicle or content mod

1. Download the mod as a .zip file. Good sources are the BeamMP mod repository and the official BeamNG.drive resources page. Keep the file as a .zip. Do not extract it.
2. Open the Files tab on your server and navigate to Resources/Client. If the Resources or Client folder does not exist yet; create it. The capitalization must match exactly.
3. Upload the .zip into Resources/Client. You can drag it into the file manager or use SFTP if you are uploading several mods or mods larger than 100MB. SFTP details are in the Settings tab.
4. Restart the server from the Console tab.
5. Join the server. The mod downloads automatically, and you will see it apply once you spawn or open the vehicle selector.

That is it. Every player who joins will receive the mod the same way.

Adding a server-side (Lua) mod

Server-side mods are Lua plugins and are installed differently:

1. Open the Files tab and go to Resources/Server. Create the folder if it does not exist.
2. Upload the plugin. A Lua plugin is usually a folder containing a main.lua file, not a single zip. Follow the instructions that came with the specific plugin.
3. Restart the server.

Things to keep in mind

• Disk usage. Mods count against your server's disk space. Large vehicle packs add up. Check your usage in the panel if uploads start failing. Need more storage? Please open a ticket.
• Join times. Players download all client mods when they connect, so a large mod set means longer first-time join times for your players.
• Compatibility. The mod must be a client-compatible BeamNG.drive mod and should match your current game and server version. An outdated mod can fail to load or cause errors.

Troubleshooting

The mod is not showing up in game.
Confirm the .zip is in Resources/Client and not somewhere else, that you did not extract it, and that you restarted the server after uploading.

Players join but never receive the mod.
Check that the file is a valid .zip and that it is in Resources/Client. Files placed in Resources/Server are not sent to players.

The server errors or crashes on start after adding a mod.
Remove the mod you just added and restart. If the server comes up clean, the mod is likely broken or incompatible with your current version. Check the Console log for the specific error. We suggest that multiple mods are not added at a time, but rather, test one to two at a time to ensure the mods are working. Failing to ensure mods are not broken can lead to minutes or sometimes hours of troubleshooting.

If you need help, open a ticket and include the mod name, where you placed it, and your Console log.