MonoDetour

Easy and convenient .NET detouring library, powered by MonoMod.RuntimeDetour.

• GitHub: https://github.com/MonoDetour/MonoDetour
• Documentation: https://monodetour.github.io/

Note: MonoDetour is a library for developers. By itself, it does the following once it's loaded by the runtime:

• ILHooks (includes HarmonyX transpilers) will get MonoDetour's CIL analysis on target method compilation when an InvalidProgramException is thrown
• If an ILHook manipulator method throws on legacy MonoMod.RuntimeDetour, it will be disabled so the target method can be ILHooked successfully later
• MonoMod's ILLabels won't cause InvalidCastExceptions in some Mono.Cecil.Cil.Instruction methods, such as ToString.

Note: do not depend on this package directly. Instead depend on MonoDetour_BepInEx_5 or MonoDetour_BepInEx_6 as it will integrate MonoDetour's logger with BepInEx and provides HarmonyX interop support.

Why Use MonoDetour?

MonoDetour is an alternative to HarmonyX or MonoMod.RuntimeDetour for detouring. It attempts to improve on the hooking experience as much as possible. See https://monodetour.github.io/getting-started/why-monodetour/ to learn more.

Changelog

MonoDetour's changelogs can be found in GitHub releases: https://github.com/MonoDetour/MonoDetour/releases

Thunderstore Specific Versions

MonoDetour adds a padding version for Thunderstore releases to allow uploading MonoDetour packages to new Thunderstore communities without desyncing the version between Thunderstore releases and other releases like NuGet. The Thunderstore version is calculated from the MonoDetour version like so: major.minor.(patch * 100 + thunderstore-sub-version).

This Thunderstore specific changelog lists Thunderstore communities MonoDetour has been added to. Also note that this changelog is shared for all MonoDetour packages.

0.7.1701

• added to mycopunk (BepInEx 5)

Earlier Versions

BepInEx 5

• added to lethal-company
• added to repo
• added to riskofrain2
• added to peak
• added to hollow-knight-silksong
• added to gloomwood
• added to yapyap
• added to super-battle-golf
• added to mycopunk
• added to resonite (special all-in-one package)

BepInEx 6

• added to resonite