pardeike/Harmony
Harmony
Harmony is a library for modifying, replacing, and decorating compiled .NET and Mono methods during execution without altering binary files on disk. It functions as a runtime method patching tool, a CIL instruction manipulator, and a reflection extension for C#.
The project provides mechanisms to intercept method execution, allowing custom code to run before or after original methods while maintaining the existing program flow. It enables the analysis and rewriting of Common Intermediate Language instructions to change the internal logic of compiled methods.
The toolkit also includes utilities for accessing and modifying private fields and methods within external classes to interact with hidden internal state.
Features
- Runtime Method Patching - Allows changing the behavior of compiled .NET code during execution without modifying binary files on disk.
- CIL Logic Rewriting - Analyzes and rewrites Common Intermediate Language instructions to change the internal logic of compiled methods.
- Bytecode Rewriting - Analyzes and rewrites method bytecode streams to change internal logical branches and variable assignments.
- JIT Instruction Detouring - Redirects method calls to substitute implementations by rewriting jump instructions in the runtime machine code.
- Runtime Execution Interception - Intercepts the execution of .NET methods to inject custom behavior while preserving original logic.
- Runtime Memory Redirection - Implements the ability to swap a target function's memory address with a new implementation at runtime.
- Intermediate Language Editors - Alters low-level CIL instructions at runtime to change internal method logic and execution flow.
- Method Logic Injection - Injects custom CIL opcodes before or after original method logic to modify behavior without source changes.
- Runtime Method Patching - Modifies compiled code behavior at runtime without altering binary files on disk.
- Runtime Method Patching - Serves as a library for modifying, replacing, and decorating compiled .NET and Mono methods at runtime.
- Method Interceptors - Executes custom code before or after original methods while maintaining the existing program flow.
- Runtime Reflection - Provides low-level reflection tools to bypass access modifiers and interact with private members.
- Private Member Access - Provides utilities to retrieve or modify private fields and methods from external classes to interact with internal state.
- Instruction Rewriting - Analyzes and rewrites specific low-level instructions of a method without replacing the entire function.
- Reflection Utilities - Offers utilities to access and modify non-public fields and methods within external classes.
- Applied Patch Tracking - Provides utilities to track and manage multiple active runtime patches applied to the same method.
- Compilers and Languages - Runtime library for patching and modifying .NET methods.
