How to Add Resources (Mods) to Your BeamNG.drive (BeamMP) Server

One of the best features of BeamNG.drive (BeamMP) multiplayer is the ability to add custom vehicle mods, custom maps, sound packs, and tuning parts. When players connect to your server, BeamMP automatically downloads and installs all active server mods directly to their client before spawning them into the game.

This guide will show you how to add resources (mods) to your Cubes Hosting BeamMP server.

Step 1: Download Vehicle and Map Mods

1. Visit trusted mod sources such as the official BeamNG.drive Mod Repository or official modding community forums.
2. Download your desired mod as a .zip file.

CRITICAL NOTE: Do NOT extract or unzip the .zip files! BeamMP requires mods to remain in their original compressed .zip format.

Step 2: Upload Mods to /Resources/Server/

1. Log in to your Cubes Hosting Game Panel and select your BeamMP server.
2. Stop your server completely.
3. Open the File Manager on the left sidebar (or connect via SFTP).
4. Navigate to the following folder:

   /Resources/Server/
   

5. Click Upload in the top right corner and select your mod .zip files.
6. Once uploaded, verify that your mod files are placed directly inside /Resources/Server/.

Step 3: Performance & Load Time Best Practices

Because connecting players must download every resource from your server before entering the game:

• Optimize Mod File Sizes: Avoid uploading oversized mod packs. Keeping individual vehicle mods under 50MB–100MB ensures fast loading times for your players.
• Remove Unused Mods: Delete old or unneeded .zip files from /Resources/Server/ to prevent unnecessary download wait times on join.
• Custom Maps: If you upload a custom map .zip, remember to update Map = "/levels/map_name/main.level.json" in ServerConfig.toml (see our BeamMP Map Configuration Guide).

Step 4: Restart Your Server & Test In-Game

1. Go to your server Console and click Start.
2. Watch the console startup logs—BeamMP will display a list of all loaded .zip resource files.
3. Connect to your server in-game. BeamMP will display a progress bar downloading the mods to your client.
4. Press Ctrl + E (or open the Vehicle Selector) in-game to select and drive your new custom vehicles!

Troubleshooting Mod Issues

• Mod Vehicle Missing Textures (Orange Textures): Ensure the mod is updated for the latest BeamNG.drive game version. Outdated vehicle mods can break textures or physics.
• Server Fails to Load Mod: Ensure the .zip file is placed directly in /Resources/Server/ and not nested inside subfolders.

Conclusion

Adding custom resources and mods to your BeamMP server takes just a few clicks. Upload your .zip files to /Resources/Server/, restart your server, and enjoy driving custom vehicles with your community!