ngzz-mc/.github/copilot-instructions.md

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