harmony

HarmonyLib is used for runtime patching of .NET C# code, allowing you to modify application behavior without altering original source files. It enables dynamic injection of custom logic into existing methods.

HarmonyLib uses prefix and postfix patches to intercept target methods. Prefix patches run before the original method to modify inputs or skip execution, while postfix patches run after to alter the return value.

Yes, the guide covers transpilers alongside prefix and postfix patches. Transpilers allow you to directly manipulate the IL code instructions of a method for highly precise and complex runtime modifications.

Yes, this guide specifically focuses on Kitten Space Agency (KSA) modding patterns. It provides the conventions and best practices required to safely apply HarmonyLib patches for KSA customization.

Safe runtime patching requires following best practices such as using precise patch targeting, avoiding conflicting modifications, and properly handling transpiler IL manipulation to ensure application stability.

Use a transpiler when you need to modify the internal IL instructions of a method, rather than using a prefix patch which is sufficient for simply intercepting, skipping, or altering method parameters and return values.