🛠️ C# 开发基础（ONI Mod 专用）

在编写《缺氧（Oxygen Not Included, ONI）》Mod 代码之前，你需要掌握一些 C# 的核心概念。本篇内容将专门围绕 ONI Mod 开发中最常见、最实用的语法与结构展开，避免泛泛而谈。

---

📦 一、命名空间与类（Namespace & Class）

《缺氧》的源码规模非常庞大，因此大量使用 命名空间（namespace） 来对功能进行划分。你的 Mod 代码也应当遵循这一习惯，以避免冲突、提升可维护性。

✅ 开始

💡 建议

如果不知道什么是 空间命名（namespace） 类名（Class） 方法名（Method） 是什么的，在这里你就可以止步了，可以花点时间快速了解一下 C# ，这会让你后续的开发事半功倍。

• C# 杂七杂八
• Harmony的小整理
• Harmony官方文档。

---

---

🔧 二、HarmonyPatch：精准定位游戏源码

在《缺氧》Mod 开发中，[HarmonyPatch] 属性（Attribute）就像一个手术定位仪。它告诉补丁框架：你需要拦截哪个“类”里的哪个“方法”。

1. 核心语法：三种定位方式

根据目标方法的复杂程度，你通常会用到以下三种写法：

定位类型	代码示例 (Attribute)	适用场景
基础定位	[HarmonyPatch(typeof(Db), "Initialize")]	最常用。目标类中只有一个同名方法时使用。
重载定位	[HarmonyPatch(typeof(Assets), "GetSprite", new Type[] { typeof(HashedString) })]	当方法有多个重载（名字相同但参数不同）时，必须指定参数类型。
属性定位	[HarmonyPatch(typeof(BuildingDef), "IsSolid", MethodType.Getter)]	专门用于拦截 C# 的 属性 (Property)。需指定是修改 Getter 还是 Setter。

---

2. 🔍 实战：如何从 dnSpy 提取 Patch 信息？

当你使用 dnSpy 查看游戏源码 Assembly-CSharp.dll 时，请按照以下逻辑进行拆解：

• 类名 (Class)：看代码最顶层的 public class 后面跟着的单词。
  • 源码：public class GeneratedBuildings
  • 对应参数：typeof(GeneratedBuildings)
• 方法名 (Method)：看括号左边的那个单词。
  • 源码：public static void LoadGeneratedBuildings(...)
  • 对应参数："LoadGeneratedBuildings"
• 参数类型 (Parameters)：看括号里面的内容，如果是重载方法则需要提取。
  • 源码：(ICollection<Type> types)
  • 对应参数：new Type[] { typeof(ICollection<Type>) }

---

3. 📝 标准代码结构模板

using HarmonyLib; // 必须引用 Harmony 库
using UnityEngine; // 如果用到 Debug.Log 或 GameObject

namespace MyOniMod
{
    // 1. 定位：我们要改哪个类的哪个方法？
    [HarmonyPatch(typeof(EntityConfigManager), "LoadGeneratedEntities")]
    public class MyEntityPatch
    {
        // 2. 注入：在原方法执行后（Postfix）做点什么？
        public static void Postfix()
        {
            // 你的逻辑代码
            Debug.Log("ONI Mod: 游戏实体加载完成！");
        }
    }
}