https://github.com/BepInEx/HarmonyX

Harmony built on top of MonoMod.RuntimeDetours with additional features
https://github.com/BepInEx/HarmonyX

csharp dotnet hacktoberfest harmony monomod patching runtime

Last synced: 4 days ago
JSON representation

Harmony built on top of MonoMod.RuntimeDetours with additional features

• Host: GitHub
• URL: https://github.com/BepInEx/HarmonyX
• Owner: BepInEx
• License: mit
• Created: 2019-12-21T12:14:27.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-07-24T04:08:38.000Z (4 months ago)
• Last Synced: 2024-10-06T09:48:42.616Z (about 1 month ago)
• Topics: csharp, dotnet, hacktoberfest, harmony, monomod, patching, runtime
• Language: C#
• Homepage:
• Size: 14.9 MB
• Stars: 356
• Watchers: 13
• Forks: 44
• Open Issues: 27
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        


	





	

		

	



***



	A library for patching, replacing and decorating .NET and Mono methods during runtime. Now powered by MonoMod.RuntimeDetour!



***

## About

**HarmonyX** is a fork of [Harmony 2](https://github.com/pardeike/Harmony) that specializes on support for games and game modding frameworks.

HarmonyX is being developed primarily for use in game frameworks alongside MonoMod. The main target usage of HarmonyX is [BepInEx](https://github.com/BepInEx/BepInEx) and Unity.

Important aspects of HarmonyX include:

* Unity support first: builds for .NET Framework 3.5 and .NET Standard 2.0

* Patching feature parity with Harmony while reducing code duplication using MonoMod.RuntimeDetour

* Fast release schedule: get periodic stable releases off [NuGet](https://www.nuget.org/packages/HarmonyX/) or [GitHub](https://github.com/BepInEx/HarmonyX/releases), or download the latest CI build with [nightly.link](https://nightly.link/BepInEx/HarmonyX/workflows/build/master/HarmonyX)

* Full interop with [MonoMod.RuntimeDetour](https://github.com/MonoMod/MonoMod/blob/master/README-RuntimeDetour.md): patches made with either can coexist

* Easily extendable patching: [built-in support for native method patching](https://github.com/BepInEx/HarmonyX/wiki/Valid-patch-targets#native-methods-marked-extern) and possibility to extend to other patch targets (e.g. IL2CPP)

* Fixes, changes and optimizations aimed at Unity modding

HarmonyX is powered by [MonoMod](https://github.com/MonoMod) and its runtime patching tools.

## Documentation

Check the documentation out at [HarmonyX wiki](https://github.com/BepInEx/HarmonyX/wiki).