Subnautica: Below Zero Support for Vortex

Description

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.




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 plugin/patcher combos

Any of the following structures are valid:

- patchers
- MyBepInExPatcher.dll
- plugins
- MyBepInExPlugin.dll

- patchers
- My Mod Name
- MyBepInExPatcher.dll
- plugins
   - My Mod Name
- MyBepInExPlugin.dll

- BepInEx
- patchers
- MyBepInExPatcher.dll
- plugins
- MyBepInExPlugin.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.

- CustomHullPlates
- HullPlates
- MyHullPlate
- icon.png
- info.json
- texture.png

- HullPlates
- MyHullPlate
- icon.png
- info.json
- texture.png

- MyHullPlate
- icon.png
- info.json
- texture.png


CustomPosters addon packs

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.

- CustomPosters
- Posters
- MyPoster
- icon.png
- info.json
- texture.png

- Posters
- MyPoster
- icon.png
- info.json
- texture.png

- MyPoster
- icon.png
- info.json
- texture.png


Mixed CustomHullPlates/CustomPosters addon packs

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.

- CustomHullPlates
- HullPlates
- MyHullPlate
- icon.png
- info.json
- texture.png
- CustomPosters
- Posters
- MyPoster
- icon.png
- info.json
- texture.png

- HullPlates
- MyHullPlate
- icon.png
- info.json
- texture.png
- Posters
- MyPoster
- icon.png
- info.json
- texture.png

- MyHullPlate
- icon.png
- info.json
- texture.png
- MyPoster
- icon.png
- info.json
- texture.png


My mod is being installed strangely!

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.