# MC 项目规则（Cursor）

项目：用 Go 实现的类 Minecraft 体素沙盒游戏。

在回答任何与本仓库代码 / 设计相关的问题前，必须：

1. 先读取 `文档/索引.md`（书签式目录），按 §7 决策树定位文档；
2. 通读对应文档后再生成代码或建议；
3. 涉及协议 / 存档格式 / Mod API / 场景算法的改动，要求先更新文档并登记索引；
4. 遵循 `文档/开发规范.md`（Go 风格、错误处理、并发、Conventional Commits）。

## 主题 → 文档映射

| 主题 | 文档 |
| --- | --- |
| Chunk / 异步生成 / 锁 | 文档/场景/区块管理.md |
| 地形 / 噪声 / 洞穴 | 文档/场景/世界生成.md |
| 生物群系 / 树 / 随机刻 / 液体 | 文档/场景/世界生态.md |
| 渲染 / mesh / 图集 / GL / 光影 | 文档/场景/渲染.md |
| 材质包 / 光影包 / 内容包 | 文档/设计.md §1.3、文档/场景/渲染.md §9 |
| 热更新 / 热重载 | 文档/场景/热更新.md |
| 光照 / 火把 | 文档/场景/光照.md |
| 物理 / 碰撞 / 移动 | 文档/场景/物理与碰撞.md |
| 方块交互 / 破坏 / 耐久 / crack | 文档/场景/方块交互与动画.md |
| 红石 / 活塞 / 方块更新 | 文档/场景/红石与方块更新.md |
| 实体 / AI / 掉落物 | 文档/场景/实体系统.md |
| 物品 / 背包 / 配方 / 容器 | 文档/场景/物品与背包.md |
| 工作台 / 合成表 | 文档/场景/工作台与合成表.md |
| 挖矿 / 矿物 | 文档/场景/挖矿与矿物.md |
| 动物 / 繁殖 / 驯服 | 文档/场景/动物体系.md |
| 村庄 / 村民 / 建造 | 文档/场景/村民系统.md |
| 僵尸 / 敌对生物 | 文档/场景/僵尸与敌对生物.md |
| UI / 拖拽 / 输入 | 文档/场景/UI与输入.md |
| UI 一比一还原 / 界面布局 | 文档/场景/UI还原.md |
| 音频 | 文档/场景/音频.md |
| 多人同步 / 防作弊 | 文档/场景/多人同步.md、文档/网络协议.md |
| 存档 / 持久化 | 文档/场景/存档与持久化.md、文档/存档格式.md |
| 性能 / GC / pprof | 文档/场景/性能与内存.md |
| 网络 / 多人 | 文档/网络协议.md |
| Mod | 文档/Mod开发指南.md |
| 测试 / CI | 文档/测试与质量.md |
| 构建 / 发布 | 文档/构建与发布.md |
| 编码规范 | 文档/开发规范.md |
| 规划 | 文档/路线图.md |