QModManager

Config based patch management for Subnautica and Subnautica: Below Zero

https://www.nexusmods.com/subnautica/mods/201/
https://www.nexusmods.com/subnauticabelowzero/mods/1/

---

This file will not provide a step-by-step tutorial for creating mods!

While creating a mod, you can use the 0Harmony-1.2.0.1.dll found in the Managed folder to patch methods at runtime and change their code.

Your mod must have a static method with no parameters that must be in a class which needs to be in a namespace. That method will be called when the game loads to load the mod. This is usually where you want to make your calls to SMLHelper or patch methods using Harmony.

The patch method and the build DLL file name will be specified in the mod.json file.

Example:

Mod.cs

using Harmony;

namespace MyNamespace
{
    class MyClass
    {
        static void PatchMethod()
        {
            HarmonyInstance.Create("AwesomeMod").PatchAll();
        }
    }
}

mod.json

{
  ...
  "AssemblyName": "MyMod.dll",
  "EntryMethod": "MyNamespace.MyClass.PatchMethod",
  ...
}

To support your mod for the QMods system, you need to learn how the mod.json file works. It contains informations about a mod, and it can have the folling keys:

• Id: Your unique mod id. Can only contain alphanumeric characters and underscores.
  (required)
  Type: string
  Example: "BestMod"

• DisplayName: The display name of your mod. Just like the mod id, but it can contain any type of characters.
  (required)
  Type: string
  Example: "Best Mod"

• Author: Your username. Should be the same across all your mods. Can contain any type of characters.
  (required)
  Type: string
  Example: "Awesome Guy"

• Version: The mod version. This needs to be updated every time your mod gets updated (please update it).
  (required)
  Type: string
  Example: "1.0.0"

• Dependencies: Other mods that your mod needs. If a dependency is not found, the mod isn't loaded.
  (optional, defaults to [])
  Type: string[]
  Example: [ "DependencyModID" ]

• VersionDependencies: Just like Dependencies, but you can specify a version range for the needed mods.
  (optional, default to {})
  Type: Dictionary<string, string>
  Example: { "SMLHelper": "2.0", "AnotherVeryImportantMod": "1.2.3" }
  Note that the version you specify here will be treated as the new "minimum required version".
  If the dependency mod is out of data, QModManager won't load this one.

• LoadBefore: Specify mods that will be loaded after your mod. If a mod in this list isn't found, it is simply ignored.
  (optional, defaults to [])
  Type: string[]
  Example: [ "AModID", "SomeOtherModID" ]

• LoadAfter: Specify mods that will be loaded before your mod. If a mod in this list isn't found, it is simply ignored.
  (optional, defaults to [])
  Type: string[]
  Example: [ "AnotherModID" ]

• Enable: Whether or not to enable the mod.
  (optional, defaults to true)
  Type: bool
  Example: true

• Game: The game that this mod is for. Can be "Subnautica", "BelowZero", or "Both"
  (optional, defaults to "Subnautica")
  Type: string
  Example: "Subnautica"

• AssemblyName: The name of the DLL file which contains the mod.
  (required)
  Type: string
  Example: "BestMod.dll"

• EntryMethod: The method which is called to load the mod. The method must be public, static, and have no parameters.
  (required)
  Type: string
  Example: "BestMod.QMod.Patch"
  Note: This is not longer required.
  See the new wiki for details on how you can identify your patching method without setting it in the manifest file.

The final result would look something like this:

{
  "Id": "BestMod",
  "DisplayName": "Best Mod",
  "Author": "Awesome Guy",
  "Version": "1.0.0",
  "Dependencies": [ "DependencyModID" ],
  "VersionDependencies": { 
    "SMLHelper": "2.0", 
    "AnotherVeryImportantMod": "1.2.3" 
  },
  "LoadBefore": [ "AModID", "SomeOtherModID" ],
  "LoadAfter": [ "AnotherModID" ],
  "Enable": true,
  "Game": "Subnautica",
  "AssemblyName": "BestMod.dll",
  "EntryMethod": "BestMod.QMod.Patch"
}

Please note that you need to add commas after each value except the last one. If you get a "mod.json deserialization failed" error, check the mod.json file on an online json validator.

---