🧩 ONIModTutorial

[![VitePress](https://img.shields.io/badge/Docs-VitePress-4FC08D)](https://vitepress.vuejs.org/) _📘 《缺氧（Oxygen Not Included）》Mod 开发教程 · 从入门到进阶 · 长期维护_
--- ## 🎯 仓库目标 - 帮助新人快速入门 ONI Mod 开发 - 系统整理缺氧 Mod 常用技术与思路 - 记录 Harmony 补丁、反编译、组件分析等实战经验 - 作为长期维护的知识库，而不是零散笔记 --- ## 📚 教程内容概览 教程内容主要包括（并持续补充中）： - 缺氧 Mod 开发基础认知 - 开发环境搭建 - Mod 基本结构与加载流程 - C# 基础（面向 ONI Mod） - Harmony 补丁详解与实战 - dnSpy / 反编译分析游戏源码 - 常见系统解析（建筑、复制人、植物、逻辑、UI 等） - 实用代码示例与踩坑记录 --- ## 📁 仓库结构说明 - content/ 教程正文内容，所有章节均以 `.md` 文件形式存在 - preface.md —— 教程引言 - csharp-basics.md —— C# 基础（ONI Mod 向） - harmony-reference.md —— Harmony 补丁整理与示例 - 其他章节持续增加中… - .github/workflows/ GitHub Actions 配置（如自动构建文档） - vitepress/ VitePress 文档站点配置 - public/ 文档站点用到的静态资源 --- ## 🚀 本地测试 ### 直接阅读（推荐） - 直接在 GitHub 中按顺序阅读 `content` 目录下的 Markdown 文件即可 ### 本地测试运行文档站点（可选） 1. 安装 Node.js（推荐使用 v16 及以上长期支持版本【LTS】windows系统确保安装时勾选添加到 PATH） [Node.js下载及安装](https://nodejs.org/zh-cn/download) 安装完成后，打开终端（如 bash、PowerShell、CMD 等），输入 `node -v` 确认安装成功并正确添加Node到系统环境变量中。 2. 克隆仓库 ``` git clone https://github.com/ChiYuKe/ONIModTutorial.git ``` 3. 安装依赖 ``` npm install ``` 4. 启动本地文档 ``` npm run dev ``` 5. 浏览器访问终端提示的本地地址，通常是 `http://localhost:端口号/ONIModTutorial/` ``` http://localhost:5173/ONIModTutorial/ ``` 6. 在浏览器尽情阅读 --- ## 🧠 适合人群 ✔ 想制作《缺氧》Mod 的玩家 ✔ 有一定 C# 基础，想深入理解 ONI 内部逻辑 ✔ 希望系统学习 Harmony Patch 的开发者 ✔ 已在做 Mod，但想补齐底层理解的人 --- ## 🤝 贡献说明 欢迎任何形式的贡献，包括但不限于： - 修正教程错误 - 补充新的章节 - 提供实战案例 - 优化结构和表述 你可以通过 **Issue** 或 **Pull Request** 提交改动。 ---