Mods allow you to customize and expand your Subnautica 2 server experience by adding new gameplay features, improving mechanics, or introducing fresh content. With mods, you can create a more varied and exciting environment for you and your players. This guide shows you how to install Subnautica 2 mods on your ZAP-Hosting game server by uploading supported Lua or C++ mods to the correct folder so they load automatically when the server starts.
Once you have the correct mod files and have opened the mods folder, you can upload the mod contents.
Upload the extracted Lua or C++ mod files into the mods folder in your game server’s main directory or move them there.
Depending on the mod, this means:
- uploading a single file directly into
mods - uploading a complete mod folder into
mods - preserving the folder structure exactly as provided by the mod author
If the downloaded archive already contains a mod folder, do not change the internal structure unless the author explicitly instructs you to do so.
| Item | Action |
|---|---|
| Single Lua mod file | Upload to the mods folder |
| Single C++ mod file | Upload to the mods folder |
| Folder-based mod | Upload the entire folder to the mods folder |
Archive file like .zip | Extract first, then upload the contents |
Do not upload compressed archives unless explicitly supported
If you upload only a .zip file or another archive without extracting it, the server may not recognize the mod. Always upload the extracted files or folders unless the mod author states otherwise.
If your Subnautica 2 mods do not work, there are some common causes you should check.
| Problem | Possible Cause | Solution |
|---|---|---|
| Mod does not load | Files in wrong directory | Make sure files are in the mods folder in the main directory |
| Server starts but mod has no effect | Mod is client-only or incompatible | Check the mod page and confirm support for dedicated servers |
| Server does not start | Corrupt mod files or version conflict | Remove the last installed mod and restart the server |
| Mod files present but ignored | Uploaded archive instead of extracted files | Extract the download and upload the actual mod files |
| Multiple mods cause conflicts | Two mods modify the same function | Test each mod individually and use only compatible combinations |
If a newly installed mod causes problems, delete the corresponding file or mod folder from the mods directory and restart the server.
[main_gameserver_directory]/mods
Use only trusted mod sources Download mods only from sources you trust. Third-party files can contain broken, outdated, or harmful content. Carefully check the mod page and avoid unknown downloads without clear installation or compatibility information.
Preferred source on Google
