Harmony Patcher Executable

The executable should only be used to inject/remove the mod loader method call into/from a game’s assembly; each stage will deploy/remove all libraries required by the mod loader to function correctly. Optionally, if a Unity3D assembly is detected, the patcher will inject the Vortex In-Game Overlay (VIGO) loader method as well.

Please note that modern Unity3D games (likely version 2018 and above) are currently distributed with a restricted Mono runtime library which disables reflection. The patcher will attempt to identify games with tampered runtime libraries and replace them with untampered versions. Please inform us if/when this functionality fails to replace the library.

Given that the patcher is a standalone executable, it is possible to execute it outside Vortex but please note that the mod loader is not designed to install or manage mods on its own.

Patcher arguments

</tr> </table> Any errors which may have occurred during patch injection will be logged inside Vortex’s appdata folder “C:\Users\{YOUR_USERNAME}\AppData\Roaming\Vortex\harmonypatcher.log” [Discuss this article](https://github.com/Nexus-Mods/vortex-api/issues/14)

Argument	Description
‘-h’	Displays the help screen.
‘-g’ or ‘extension=’ i.e. ‘./VortexHarmonyExec.exe -g “../game-untitledgoose”’ </td>	(optional) Path to the game extension’s folder. Currently this is used to retrieve game-specific UI asset bundles stored inside the game’s extension folder.
‘-m’ or ‘managed=’ i.e. ./VortexHarmonyExec.exe -m “../path_to_game_assembly”	Used to define the full file path to the game assembly we wish to patch. Alternatively just a folder path can be defined and the patcher will assume we’re attempting to mod a Unity3D game and will try to load “Assembly-CSharp.dll” </td> </tr>
‘-i’ or ‘install=’ i.e. ‘-i “../lib/”’	Path to the patcher’s built dependencies - these are copied over to the game’s dataPath.
‘-e’ or ‘entry=’ i.e. ‘-e “NameSpace.ClassName::MethodName”’	The entrypoint for the patch. This defines the function where we wish to insert/inject the patcher function call for the game to use.
‘-r’ i.e. ‘./VortexHarmonyExec.exe -r’	(optional) Adding the -r argument will inform the patcher that it needs to attempt to remove the Vortex patch. The entrypoint and game assembly still need to be provided.