Harmony

<p align="center"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/645ad150-ba52-4ae8-abc3-a98ce52496e6.png" alt="Harmony" width="180" /><br> <b>版本 2.3</b><br> 一个用于在运行时修补、替换和装饰<br> .NET 和 Mono 方法的库。 </p>

关于

Harmony 为您提供了一种优雅且高级的方式来修改用 C# 编写的应用程序的功能。它在游戏中表现出色，并在以下游戏中得到广泛应用：

• Rust
• Rimworld
• 7 Days To Die
• Stardew Valley
• Subnautica
• Oxygen Not Included
• Besiege
• Cities:Skylines
• Kerbal Space Program
• Resonite
• BattleTech
• Slime Rancher

以及其他游戏如 Ravenfield、Sheltered、Staxel、The Ultimate Nerd Game、Total Miner、Unturned、SCP: Secret Laboratory 等。

它还被微软和谷歌用于 WPF 控件的单元测试，以及许多其他领域。

工作原理

如果您使用 C# 开发，并且您的代码作为模块/插件加载到主机应用程序中，您可以使用 Harmony 来修改该应用程序中所有可用程序集的功能。与其他仅允许您替换原始方法的补丁库不同，Harmony 更进一步，为您提供：

• 保持原始方法完整的方式
• 在原始方法之前和/或之后执行您的代码
• 使用 IL 代码处理器修改原始代码
• 多个 Harmony 补丁共存且互不冲突
• 在运行时工作，不触及任何文件

安装

如果您想要单个文件、依赖合并的程序集，您应该使用 Lib.Harmony nuget 包。这是首选方式。

如果您想自己提供依赖项，您应该使用 Lib.Harmony.Thin nuget 包。您可以获得更多控制权，但您需要负责在运行时提供所有引用。

文档

请查看文档并加入官方Discord 服务器。

贡献

我在这个项目及其支持上投入了数千小时。每一个小行动都有帮助：

• 成为 GitHub 赞助商或 Patreon 赞助人
• 为这个 Stack Overflow 回答点赞
• 在您的开发者社区中传播

本项目使用了 0x0ade 和 nike4613 开发的优秀 MonoMod.Core 库。

Harmony 1

Harmony 1 已被弃用，不再积极开发。其最新版本（v1.2.0.1）是稳定的，只包含一些小错误。如果您处于专门使用 Harmony 1 的环境中，请继续使用它。目前，Harmony 1.x 和 2.x 不兼容，不应混用。旧版文档仍可在 Wiki 中找到。

<br> 

<p align="center"> <a href="../../blob/master/LICENSE"><img src="https://yellow-cdn.veclightyear.com/835a84d5/bb0ec722-42ba-4434-9269-1bba8b8b8cdf.svg?style=flat-squared&label=License" /></a> <a href="../../releases/latest"><img src="https://yellow-cdn.veclightyear.com/835a84d5/cb8ed37e-8106-4635-b40b-73b44ff9cd1b.svg?style=flat-squared&label=Release" /></a> <a href="https://harmony.pardeike.net"><img src="https://img.shields.io/badge/documentation-%F0%9F%94%8D-9cf?style=flat-squared&label=Documentation" /></a> </p> <p align="center"> <a href="https://github.com/pardeike/Harmony/releases/latest"><img src="https://yellow-cdn.veclightyear.com/835a84d5/9345c9aa-f601-46f2-ab4a-2e61c5e54a6a.svg?style=flat-squared&logo=github&color=009900&label=Release%20Downloads" /></a> <a href="https://www.nuget.org/packages/Lib.Harmony"><img src="https://img.shields.io/nuget/dt/Lib.Harmony?style=flat-squared&logo=nuget&label=Nuget%20Downloads&color=009900" /></a> </p> <p align="center"> <a href="https://github.com/pardeike/Harmony/actions/workflows/test.yml"><img src="https://img.shields.io/github/actions/workflow/status/pardeike/Harmony/test.yml?style=flat-squared&logo=github&label=CI%20Tests" /></a> <a href="https://discord.gg/xXgghXR"><img src="https://yellow-cdn.veclightyear.com/835a84d5/f02fe517-3907-48ad-8a96-7e6ea471115d.svg?style=flat-squared&logo=discord&label=Official%20Discord" /></a> </p> <p align="center"> <a href="mailto:andreas@pardeike.net"><img src="https://yellow-cdn.veclightyear.com/835a84d5/831d3496-e04f-4c3f-a319-dba5aacc768c.svg?style=flat-squared&label=Email" /></a> <a href="https://twitter.com/pardeike"><img src="https://yellow-cdn.veclightyear.com/835a84d5/c87e6b7f-4745-47fb-b9f0-0a8f404810b5.svg?style=flat-squared&logo=twitter&label=Twitter" /></a> </p>