Lib.Harmony 2.0.4

A general non-destructive patch library for .NET and Mono modules

Install-Package Lib.Harmony -Version 2.0.4
dotnet add package Lib.Harmony --version 2.0.4
<PackageReference Include="Lib.Harmony" Version="2.0.4" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Lib.Harmony --version 2.0.4
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

<p align="center"><img src="https://raw.githubusercontent.com/pardeike/Harmony/master/HarmonyLogo.png" alt="Harmony" width="128" /></p>

Harmony 2.0

Introduction

Harmony gives you an elegant and high level way to alter functionality in applications written in C#. It does this at runtime by monkey patching methods unlike other solutions that change the content of dll files.

It supports Mono and .NET environments on Windows, Unix and macOS except when Unity uses the stripped down NetStandard profile (.NET 4.x profile works fine). Harmony is used in mainstream Unity games and many other applications.

Designed to be used by multiple users (usually called Mods) that would otherwise override each others hooks, it was originally created for the game RimWorld and its large modding community by Andreas Pardeike.

Enjoy!
/Andreas Pardeike

Getting Started

Installation is usually done by copying and referencing 0Harmony.dll from your project or by using the Lib.Harmony nuget package.

Documentation

You can learn more about Harmony by using the top menu links. The main section [Harmony] brings you to the full documentation that explains everything about Harmony and gives you lots of high level examples. In the second section [API Documentation] you can browse the public API and all its methods and classes.

If you find a factual error or if you have feedback about the documentation you are welcome to

  • fork the repository and create a pull request
  • file a documentation Issue on the repo
  • or write about it on the official discord

New to modding and C#? Beside the basic language features you need at least a good overview of Reflection in C#. Read this short and useful introduction.

Community

If you feel stuck or have questions that this site does not answer, feel free to join the official Discord Server or file a GitHub Issue.

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!

Contact

Andreas Pardeike
andreas@pardeike.net
twitter: @pardeike

Donations

Donations keep me going:
https://www.patreon.com/pardeike

<p align="center"><img src="https://raw.githubusercontent.com/pardeike/Harmony/master/HarmonyLogo.png" alt="Harmony" width="128" /></p>

Harmony 2.0

Introduction

Harmony gives you an elegant and high level way to alter functionality in applications written in C#. It does this at runtime by monkey patching methods unlike other solutions that change the content of dll files.

It supports Mono and .NET environments on Windows, Unix and macOS except when Unity uses the stripped down NetStandard profile (.NET 4.x profile works fine). Harmony is used in mainstream Unity games and many other applications.

Designed to be used by multiple users (usually called Mods) that would otherwise override each others hooks, it was originally created for the game RimWorld and its large modding community by Andreas Pardeike.

Enjoy!
/Andreas Pardeike

Getting Started

Installation is usually done by copying and referencing 0Harmony.dll from your project or by using the Lib.Harmony nuget package.

Documentation

You can learn more about Harmony by using the top menu links. The main section [Harmony] brings you to the full documentation that explains everything about Harmony and gives you lots of high level examples. In the second section [API Documentation] you can browse the public API and all its methods and classes.

If you find a factual error or if you have feedback about the documentation you are welcome to

  • fork the repository and create a pull request
  • file a documentation Issue on the repo
  • or write about it on the official discord

New to modding and C#? Beside the basic language features you need at least a good overview of Reflection in C#. Read this short and useful introduction.

Community

If you feel stuck or have questions that this site does not answer, feel free to join the official Discord Server or file a GitHub Issue.

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!

Contact

Andreas Pardeike
andreas@pardeike.net
twitter: @pardeike

Donations

Donations keep me going:
https://www.patreon.com/pardeike

  • .NETCoreApp 3.0

  • .NETCoreApp 3.1

  • .NETFramework 3.5

    • No dependencies.
  • .NETFramework 4.5

    • No dependencies.
  • .NETFramework 4.7.2

    • No dependencies.
  • .NETFramework 4.8

    • No dependencies.

NuGet packages (22)

Showing the top 5 NuGet packages that depend on Lib.Harmony:

Package Downloads
OpenMod.Core
Core service implementations for OpenMod
OWML
Mod loader and mod framework for Outer Wilds
UnlimitedHugs.Rimworld.HugsLib
A lightweight shared library for Rimworld modding.
Bannerlord.MBOptionScreen
Package Description
Bannerlord.MCM
A library for easy Setting integration. Contains the abstraction library, requires the Standalone dependency to work!

GitHub repositories (15)

Showing the top 5 popular GitHub repositories that depend on Lib.Harmony:

Repository Stars
Sonarr/Sonarr
Smart PVR for newsgroup and bittorrent users.
SubnauticaNitrox/Nitrox
An open-source, multiplayer modification for the game Subnautica.
JetBrains/resharper-unity
Unity support for both ReSharper and Rider
CitiesSkylinesMultiplayer/CSM
Source code for the Cities: Skylines Multiplayer mod (CSM)
skyarkhangel/Hardcore-SK
Rimworld Hardcore SK project, our portal:

Version History

Version Downloads Last updated
2.0.4 2,465 10/31/2020
1.2.0.1 84,310 8/8/2018