ONI Agent Bridge - initial mod implementation

ONIModTutorial/ONIModTutorial-main/mod-structure.md

@@ -0,0 +1,49 @@
+# 📂 Mod 目录结构
+
+一个标准的《缺氧》Mod 目录通常包含以下核心文件。理解这些文件的角色是开发的第一步。
+
+## 一 . 典型结构总览
+
+每个模组都使用一个单独文件夹，例如，你的`MyFirstMod`路径应该如下所示： 
+`...\Klei\OxygenNotIncluded\mods\Dev\MyFirstMod\`
+* `MyFirstMod.dll`
+* `mod.yaml`
+* `mod_info.yaml`
+```text
+MyFirstMod/
+├── mod_info.yaml           #  Mod 的元数据与版本兼容性配置
+├── mod.yaml                #  用于配置 Mod 的名称、描述等静态信息
+├── MyFirstMod.dll               #  编译后的程序集文件（逻辑代码）
+└── preview.png             #  Steam 创意工坊显示的预览图
+
+```
+## 二 . 配置文件详解
+::: code-group
+```yaml [mod_info.yaml 模板]
+supportedContent: ALL       # 支持范围：VANILLA_ID, EXPANSION1_ID, 或 ALL
+minimumSupportedBuild: 512719 # 运行该 Mod 所需的最低游戏版本号
+version: "1.0.0"            # 你自己的 Mod 版本号
+```
+:::
+
+
+::: code-group
+```yaml [mod.yaml 模板]
+title: "MyFirstMod"  # 游戏内 Mod 列表显示的名称
+description: "这是一个示例描述"  # 游戏内显示的详细功能介绍
+staticID: "AuthorName.MyMod"  # Mod 的唯一标识符（建议格式：作者名.Mod名）
+```
+:::
+
+
+
+
+
+
+## 三 . 资源与可选目录 (进阶)
+当你的 Mod 不再仅仅是简单的逻辑修改，而是涉及新建筑、新美术或多语言支持时，需要建立以下目录结构：
+* **/translations/：** 用于存放多语言翻译文件（.pot 或 .po）。
+* **/anim/assets/：** 存放自定义建筑、生物或掉落物的动画资源。
+* **/assets/：** 额外素材
+* **/elements/：** 存放自定义元素的配置数据。
+* **/worldgen/：** 涉及地形生成、生物群落（Biomes）修改时的核心目录。包含 `biomes`、`features` 等子文件夹。