新增Disciple弟子数据类与DiscipleManager管理器及弟子属性设计文档

2026-09-08 22:49:23 +08:00
parent 18a69f1a17
commit bea9300d2b
6 changed files with 732 additions and 0 deletions
@@ -83,3 +83,36 @@ func load_from_dict(d) -> void
   - `settle_month` → 境界提升/灵石消耗正确
   - `to_dict / load_from_dict` 往返一致
 3. `print` 输出 PASS/FAIL，编辑器直接运行场景验证
+
+# 弟子属性
+
+## 属性列表
+|名称|范围|说明|
+|:---|:---|:---|
+|metal|[0, 100]|金属性值|
+|wood|[0, 100]|木属性值|
+|water|[0, 100]|水属性值|
+|fire|[0, 100]|火属性值|
+|earth|[0, 100]|土属性值|
+|efficiency|[1, 100]|灵气吸收效率，决定修炼速度，隐藏属性|
+|realm_level|[0, 5]|大境界，凡人、练气、筑基、金丹、元婴、化神|
+|sub_realm_level|[1, 13]|凡人只有一个小境界；练气13个小境界，其他各有前、中、后、大圆满四个小境界|
+|cultivation_exp|[0, 2147483647]|修炼经验|
+|farming_skill_exp|[0, 2147483647]|耕作技能经验|
+|farming_skill_level|[0, 10]|炼丹技能等级|
+|herb_farming_skill_exp|[0, 2147483647]|药草耕作技能经验|
+|herb_farming_skill_level|[0, 10]|炼丹技能等级|
+|alchemy_skill_exp|[0, 2147483647]|炼丹技能经验|
+|alchemy_skill_level|[0, 10]|炼丹技能等级|
+|loyalty|[0, 100]|忠诚度|
+
+- **修炼经验说明**：每个小境界都有一个经验上限，跨越小境界，溢出部分会继承到下一个小境界。跨越大境界，溢出部分清零。
+
+- **技能经验说明**：耕作技能经验、药草耕作技能经验、炼丹技能经验，每跨越一个等级，溢出的经验会继承到下一个等级，直到升满为止，不会有任何经验提升。每个等级所需的经验为需要在文件中配置。
+
+
+## 初始分配方式
+```mermaid
+graph TD
+   A[分配属性总量，按正正态分布] --> B[随机分配5种属性，属性之和为1] --> C[分配灵气利用率]
+```