chore:首次提交

2026-05-11 17:39:31 +08:00
parent 906f1cf468
commit 83e99a7ef8
109 changed files with 19558 additions and 0 deletions
@@ -0,0 +1,34 @@
+# ADR-003: 使用 JSON 数据的 Mod 系统
+
+## Status
+Accepted
+
+## Date
+2026-05-10
+
+## Context
+需要实现 Mod 生态系统，要求:
+- 玩家可以制作和分享 Mod
+- Mod 可以添加新内容和修改现有内容
+- 加载顺序可控制
+- 冲突可以检测和解决
+
+## Decision
+使用 JSON 数据文件作为 Mod 格式。
+
+- Mod 格式: JSON 数据 + manifest.json 清单
+- 加载方式: 深度合并，后加载覆盖先加载
+- 优先级: 数字越小越先加载
+- 事件钩子: GameEvents.on() 让 Mod 响应游戏事件
+- 验证: JSON Schema 确保数据结构合规
+
+选择此方案而非:
+- 二进制格式 (不可读，难以调试)
+- 脚本语言 (安全风险，性能问题)
+- 文件系统覆盖 (浏览器限制)
+
+## Consequences
+- Mod 格式简单易懂，玩家容易上手
+- JSON 可以被任何文本编辑器修改
+- 深度合并可能产生意外覆盖，需要冲突检测
+- 运行时加载性能良好