# GitHub Copilot 指令

本仓库为 Go 项目（类 Minecraft 体素沙盒游戏）。生成或修改代码前：

1. 先读取 `文档/索引.md`（书签式目录）确定相关文档；
2. 遵循 `文档/开发规范.md`（命名、错误处理、并发、Git 提交格式）；
3. 协议 / 存档格式 / Mod API / 场景算法变更必须同步更新对应文档与索引；
4. 目录结构遵循 `文档/设计.md` §1.1，不要臆造结构。

## 主题速查

- Chunk / 异步生成：文档/场景/区块管理.md
- 地形 / 噪声：文档/场景/世界生成.md
- 生物群系 / 生态：文档/场景/世界生态.md
- 渲染 / 光影：文档/场景/渲染.md
- 材质包 / 光影包 / 内容包：文档/设计.md §1.3、文档/场景/渲染.md §9
- 热更新 / 热重载：文档/场景/热更新.md
- 光照 / 火把：文档/场景/光照.md
- 物理 / 碰撞：文档/场景/物理与碰撞.md
- 方块交互 / 破坏 / 耐久：文档/场景/方块交互与动画.md
- 红石 / 活塞：文档/场景/红石与方块更新.md
- 实体 / AI：文档/场景/实体系统.md
- 物品 / 背包 / 配方：文档/场景/物品与背包.md
- 工作台 / 合成表：文档/场景/工作台与合成表.md
- 挖矿 / 矿物：文档/场景/挖矿与矿物.md
- 动物 / 繁殖：文档/场景/动物体系.md
- 村庄 / 村民 / 建造：文档/场景/村民系统.md
- 僵尸 / 敌对生物：文档/场景/僵尸与敌对生物.md
- UI / 输入：文档/场景/UI与输入.md
- UI 一比一还原：文档/场景/UI还原.md
- 音频：文档/场景/音频.md
- 多人同步：文档/场景/多人同步.md、文档/网络协议.md
- 存档 / 持久化：文档/场景/存档与持久化.md、文档/存档格式.md
- 性能 / GC：文档/场景/性能与内存.md
- 网络：文档/网络协议.md
- Mod：文档/Mod开发指南.md
- 测试：文档/测试与质量.md
- 构建 / 发布：文档/构建与发布.md
- 路线图：文档/路线图.md