/Harmony

A library for patching, replacing and decorating .NET and Mono methods during runtime

Primary LanguageC#MIT LicenseMIT

Archived: Nitrox uses HarmonyX as a nuget dependency

Harmony


A library for patching, replacing and decorating .NET and Mono methods during runtime.


Harmony gives you an elegant and high level way to alter the functionality in applications written in C#. It works great in games and is in fact well established in games like

  • Rimworld
  • BattleTech
  • The Long Dark
  • Oxygen Not Included
  • Subnautica
  • 7 Days To Die
  • Cities: Skylines
  • Kerbal Space Program
  • Besiege
  • Stardew Valley
  • Staxel
  • Total Miner
  • Ravenfield
  • The Ultimate Nerd Game

It is also used in unit testing Windows Presentation Foundation controls and in many other areas.

If you develop in C# and your code is loaded as a module/plugin into a host application, you can use Harmony to alter the functionality of all the available assemblies of that application. Where other patch libraries simply allow you to replace the original method, Harmony goes one step further and gives you:

  • A way to keep the original method intact

  • Execute your code before and/or after the original method

  • Modify the original with IL code processors

  • Multiple Harmony patches co-exist and don't conflict with each other

Installation is usually done by referencing the 0Harmony.dll (from the zip file) from your project or by using the Lib.Harmony nuget package.

Please check out the documentation on the GitHub Wiki or join us at the official discord server

Also, an introduction to Transpilers: Simple Harmony Transpiler Tutorial


Help by promoting this library so other developers can find it. One way is to upvote this stackoverflow answer. Or spread the word in your developer communities. Thank you!

For more information from me and my other open source projects, follow me on twitter: @pardeike

Hope you enjoy Harmony!