Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou are not allowed to upload this file to other sites under any circumstances
Modification permissionYou must get permission from me before you are allowed to modify my files to improve it
Conversion permissionYou are not allowed to convert this file to work on other games under any circumstances
Asset use permissionYou must get permission from me before you are allowed to use any of the assets in this file
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou are not allowed to earn Donation Points for your mods if they use my assets
Author notes
This author has not provided any additional notes regarding file permissions
File credits
This author has not credited anyone else in this file
Changed: Reduce disk footprint of BepInEx.AssemblyInspection.Console.exe binary
Fixed: Improve detection of whether QModManager is currently enabled with Vortex
Full changelog available at: https://github.com/toebeann/subnautica-below-zero-support/releases/tag/v2.0.3
Version 2.0.3
Users affected by an issue where some QMods were not being installed correctly should reinstall the affected QMods.
Fixed: Resolve issue where QMod archives which include a "QMods" folder result in nested "QMods" folders when installed
Full changelog available at: https://github.com/toebeann/subnautica-below-zero-support/releases/tag/v2.0.3
Version 2.0.2
Changed: Change license from LGPL-3.0 to GPL-3.0
Changed: Always expand first entry in changelogs when opening dialog
Fixed: Correct handling of `BepInEx.cfg` for BepInEx packs without an included `BepInEx.legacy.cfg`
Fixed: Stop notifying users to reinstall BepInEx pack when enabling/disabling QModManager if reinstalling would not update the `BepInEx.cfg` file
Full changelog available at: https://github.com/toebeann/subnautica-below-zero-support/releases/tag/v2.0.2
Version 2.0.1
Resolve an issue where the latest changelog displays every time you switched to the Subnautica: Below Zero game mode, rather than just when an important update is released
Version 2.0.0
This release comprises a complete rewrite of the extension from scratch by the new lead maintainer, toebeann.
Filter out files which conflict with the BepInEx pack when installing QModManager
Improve the game version detection so that the actual game version is reported rather than the version of the Unity engine used to compile it
Suppress the warning about QModManager not being installed until the user has one or more QMods installed
Support installing the BepInEx Pack for Subnautica: Below Zero
Support installing BepInEx plugins and patchers
Support installing CustomPosters and CustomHullPlates addon packs (QMM only)
Notify the user that they need to install BepInEx if it is not already installed
Add a changelog GUI to automatically let users know about updates
This extension adds support for Subnautica: Below Zero to Vortex Mod Manager, enabling you to easily automate installation of mods for Subnautica: Below Zero without having to worry about where the files are supposed to go, etc.
At this time, the following mod types are supported:
BepInEx Pack for Subnautica: Below Zero
BepInEx plugins
BepInEx patchers
QModManager
QMods
CustomHullPlates addon packs
CustomPosters addon packs
If you are developing a different kind of mod and would like it to be supported by this extension, please raise an issue or pull request on the GitHub repository with a link to your mod page so that I can take a look at how you are packaging it. Please make sure to include instructions for how you would expect it to be installed, so that I can have Vortex automate the process. PRs welcome!
How to install
This extension requires Vortex ^1.9.0. To install, click the Vortex button at the top of the page to open this extension within Vortex, and then click Install. Alternatively, within Vortex, go to the Extensions tab, click "Find More" at the bottom of the tab, search for "Subnautica Below Zero Support" and then click Install.
You can also manually install it by downloading the main file and dragging it into the "drop zone" labelled "Drop File(s)" in the Extensions tab at the bottom right.
Afterwards, restart Vortex and you can begin installing supported Subnautica: Below Zero mods with Vortex.
The rest of this page is intended for mod authors only. Users can simply follow the instructions above to install, and you're done!
How to make my mod compatible with this extension?
Assuming your mod is of a supported type, simply follow the packaging examples for that mod type below.
Don't forget to set your latest main file as your main Vortex file, and make sure that the "Remove the 'Download with Manager' button" option is unticked!
If your mod is not of a supported type, you will need to raise an issue or pull request on the GitHub repository with a link to your mod page so that I can take a look at how you are packaging it. Please make sure to include instructions for how you would expect it to be installed.
Packaging examples
BepInEx plugins
Any of the following structures are valid:
- MyBepInExPlugin.dll
- My BepInEx Plugin - MyBepInExPlugin.dll
- plugins - MyBepInExPlugin.dll
- plugins - My BepInEx Plugin - MyBepInExPlugin.dll
- BepInEx - plugins - MyBepInExPlugin.dll
- BepInEx - plugins - My BepInEx Plugin - MyBepInExPlugin.dll
BepInEx patchers
Any of the following structures are valid:
- patchers - MyBepInExPatcher.dll
- patchers - My BepInEx Patcher - MyBepInExPatcher.dll
- BepInEx - patchers - MyBepInExPatcher.dll
- BepInEx - patchers - My BepInEx Patcher - MyBepInExPatcher.dll
- BepInEx - patchers - My Mod Name - MyBepInExPatcher.dll - plugins - My Mod Name - MyBepInExPlugin.dll
QMods
Any of the following structures are valid:
- My QMod - mod.json - MyQMod.dll
- QMods - My QMod - mod.json - MyQMod.dll
- mod.json - MyQMod.dll
Mods which can be installed as either a QMod or a BepInEx plugin
Mods which meet all of the following criteria are eligible to be installed as either a QMod or a BepInEx plugin:
has a mod.json manifest for QModManager
has an assembly containing a BaseUnityPlugin class with a BepInPlugin attribute applied to it
has the following structure: - My Mod - mod.json - MyMod.dll
When a user installs an eligible mod, they will be prompted to choose whether they would like to install it for QModManager or BepInEx. The one exception to this rule is when the user only has BepInEx installed but not QModManager, to prevent bugging them with annoying questions. In this case, the mod will automatically be installed as a BepInEx plugin.
CustomHullPlates addon packs
Any of the following structures are valid. Note that although these examples only include a single hull plate, the extension will happily install packs containing multiple hull plates.
Any of the following structures are valid. Note that although these examples only include a single poster, the extension will happily install packs containing multiple posters.
Any of the following structures are valid. Note that although these examples only include a single hull plate and poster each, the extension will happily install packs containing multiple of each.
If you have followed the packaging examples above and your mod is still being incorrectly installed by this extension, please raise an issue on the GitHub repository with a link to your mod page or with a sample archive attached so that I can get it fixed.