# 7dtd-modding-guide

**Repository Path**: jinngoo/7dtd-modding-guide

## Basic Information

- **Project Name**: 7dtd-modding-guide
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 七日杀 V2.6 Mod 开发文档体系

> 为 AI agent 提供从零创建 V2.6 兼容 Mod 的完整知识体系。

**适用版本**: V2.6 | **最后更新**: 2026-04 | **详细程度**: 速查

---

## 项目目的

本项目的目标是为 AI agent（如 CodeBuddy）提供一套结构化、高信息密度、可操作的文档体系，使其能够：

1. **理解 V2.6 Mod 机制** — 加载顺序、XPath 合并、DLL 加载、Config 映射
2. **从零创建 Mod** — 从目录结构到 ModInfo.xml 到 Config XML 到本地化到测试
3. **查阅准确参考** — 40 个原版 XML 文件结构、ModInfo.xml 全字段、XPath 语法
4. **集成核心框架** — 0_TFP_Harmony / Gears / Quartz / SCore / XNPCCore

所有内容基于 **V2.6 正式版实测**，非 Wiki 旧版信息。

---

## 文档结构概览

```
7dtd-modding-guide/
├── INDEX.md                  # 总索引（AI agent 入口）
├── README.md                 # 本文件
├── 01-getting-started/       # 入门：环境、加载机制、第一个 Mod、ModInfo、工作流
├── 02-xml-modding/           # XML Mod：XPath 语法、各 XML 文件修改方法
├── 03-code-modding/          # 代码 Mod：Harmony 补丁、ModAPI、DLL
├── 04-ui-modding/            # UI Mod：XUi 控件、窗口、图集
├── 05-prefab-modding/        # Prefab Mod：建筑、POI、rwgmixer
├── 06-resources/             # 资源：Unity AssetBundle、图标、模型
├── 07-frameworks/            # 框架：Harmony/Gears/Quartz/SCore/XNPCCore
├── 08-migration/             # 迁移：A21/V1.0 → V2.6
├── 09-recipes/               # 配方系统：语法、制作台、解锁
├── 10-debugging/             # 调试：日志、错误排查、冲突
├── 99-reference/             # 参考：原版 XML 结构、属性速查
└── templates/                # 模板：5 种 Mod 骨架
```

---

## 适用版本

| 项目 | 值 |
|---|---|
| 游戏版本 | 7 Days to Die **V2.6** |
| Steam buildid | 22422060 |
| Unity 引擎 | 2022.3.x |
| 文档更新 | 2026 年 4 月 |

> 本文档体系替代 `7dtd-mods/docs/modding-guide.md`。

---

## 如何使用（给 AI 的指引）

### 入口

从 [INDEX.md](INDEX.md) 开始。它包含：
- **"我要做 X"快速入口表** — 按任务场景定位文档
- **Mod 类型决策表** — 确定 Mod 类型后必读/可选文档
- **8 步标准流程** — 新 Mod 创建的完整步骤

### 阅读顺序

1. **初次接触 V2.6 Mod 开发** → 按 `01-getting-started/01` → `05` 顺序阅读
2. **有明确任务** → 从 INDEX 的"快速入口"表定位，直接跳转
3. **查特定字段/属性** → 去 `99-reference/` 或对应专项目录

### 关键约定

- 路径：游戏路径用绝对，Mod 内用相对
- 版本标注：`[V2.6]` 新增 / `[兼容A21+]` / `[已废弃]` / `[实测]`
- 代码示例：完整可运行，关键字段含行内注释
- 每文档 ≤500 行，独立自包含

### 游戏环境

| 项目 | 路径 |
|---|---|
| 游戏根目录 | `D:\SteamLibrary\steamapps\common\7 Days To Die\` |
| 原版配置 | `Data\Config\`（40 个 XML 文件） |
| Mod 目录 | `Mods\`（25 个已安装 Mod） |
| 程序集 | `7DaysToDie_Data\Managed\Assembly-CSharp.dll` |
| 日志 | `%AppData%\7DaysToDie\logs\` |

---

## 下一步

- [总索引](INDEX.md)
- [游戏环境与目录结构](01-getting-started/01-game-environment.md)