Skip to content

LEGACY HarmonyPatcher Vortex Harmony Mod Loader Mod Types

Simon Davies edited this page Apr 30, 2024 · 2 revisions

Mod types are currently identified (quite naively, but this will change) using the mod’s manifest file; the mod loader parses the manifest and verifies whether it matches the expected object schema/data for each registered mod type. If a manifest is successfully matched to a Mod Type, the mod loader will load and invoke the mod’s entry-point as defined by the Mod Type. Any unmatched mods will not be loaded.

Supported Mod Types

Vortex Mod Type - this is the default Vortex mod type, it exposes the mod’s data, a series of logging functions and GUI/Unity specific helper methods. UMM Mod Type - Experimental Unity Mod Manager Mod support is available and should be able to support any games developed in Unity 2018 and above (.NET 4.0) Please note that the Mod Loader needs to disassemble and re-assemble any UMM mods prior to being able to load them correctly. QMM Mod Type used for the Subnautica games is still in development/testing.

Exposed Mod Types

Exposed mod types refer to the objects that are actually exposed to mod assemblies and to Vortex’s Unity UI module. This is done primarily for encapsulation reasons, but also to mimic other mod managers when trying to load mods which are not natively built for Vortex’s mod loader.

Currently we use:

  • VortexMod (Exposed Vortex mod type)
  • ModEntry (Exposed Unity Mod Manager mod type)
  • QMod (Exposed QMOD Manager mod type)

Mod Settings

It’s important to understand that aside from the patch method calls - which are injected directly into the game’s assembly by the patcher executable - Vortex will not tamper, or persistently change the game’s code in any way, unless a mod is explicitly changing IL instructions when the mod loader invokes the mod’s entry-point. If IL level changes are required, please use Harmony Transpilers instead.

Harmony lib patches are designed to keep the original method intact and allows for multiple patches to co-exist without conflicting with each other while making mod removal as easy as deleting the mod’s folder. That’s all fine and dandy unless your mod is customizable, in which case you need to be able to save the mod’s state/user’s customized options, so he’s not forced to make the same changes each time he runs the game.

For this purpose, the mod loader provides an option to serialize/deserialize mod settings into json or xml documents using generic pre-defined settings classes. It is the mod author’s responsibility to load/manage/save these settings throughout his mod to ensure that it functions correctly.

Vortex

Games

Starfield

  • Troubleshooting
  • Developers

Baldur's Gate 3

  • Troubleshooting
  • Developers
  • Valheim
  • Bannerlord

Tools

  • BepInEx

Developers

Extensions

Outdated Documentation

Warning

The below documentation has not been checked for quality since migrating to GitHub Wiki and the information contained is potentially out of date and\or repeated.

Modding.wiki (Users)

General

User Interface

Game Guides

Troubleshooting

Modding.wiki (Developers)

General

Reference

Troubleshooting

Other links

Legacy

General

Tutorial

UI

Language

Feature

Harmony Patcher

Other

Clone this wiki locally