feat: 灵根改为1~5根+容量公式(1÷根数)，权重表进配置；文档同步
This commit is contained in:
+14
-12
@@ -1,7 +1,7 @@
|
||||
# 弟子系统设计（D3：生成 + 入宗分流 / D4：名录 UI）
|
||||
|
||||
> 对应开发计划表 D3（8/5）与 D4（8/6）。本文档只描述设计，不包含代码。
|
||||
> 状态：D3 已实现；D4 设计稿，待审阅通过后实现
|
||||
> 状态：D3、D4 已实现
|
||||
|
||||
---
|
||||
|
||||
@@ -15,7 +15,7 @@
|
||||
| `name` | String | 随机生成的姓名 |
|
||||
| `age` | int | 入宗年龄（12~18） |
|
||||
| `aptitude` | 枚举 Aptitude | 资质（入宗分流结果） |
|
||||
| `roots` | 枚举数组 SpiritRoot | 灵根列表（普通弟子 1~3 根，互不重复） |
|
||||
| `roots` | 枚举数组 SpiritRoot | 灵根列表（普通弟子 1~5 根，互不重复） |
|
||||
| `is_heavenly` | bool | 天灵根标记（稀有灵根，见枚举二） |
|
||||
| `join_year` | int | 入宗年份（0 = 未入宗/候选），accept 时快照 GameState |
|
||||
| `join_month` | int | 入宗月份 |
|
||||
@@ -36,7 +36,7 @@
|
||||
|
||||
### 枚举二：灵根五行（SpiritRoot）
|
||||
|
||||
金、木、水、火、土 五种。灵根数量影响修炼速度（根数越少越快），元素种类影响日后生产效率匹配（D6 建筑/职能系统使用），此处只生成不消费。
|
||||
金、木、水、火、土 五种。灵根数量影响灵气容量（容量 = 1 ÷ 根数：单灵根充满、双灵根 1/2、三灵根 1/3……五灵根 1/5，修炼速度按比例折扣），元素种类影响日后生产效率匹配（D6 建筑/职能系统使用），此处只生成不消费。
|
||||
|
||||
### 特殊灵根：天灵根
|
||||
|
||||
@@ -73,7 +73,7 @@
|
||||
|
||||
### 1. 姓名
|
||||
|
||||
- 姓氏池：24 个常用修仙风单姓（林、苏、叶、萧、顾、沈、楚、白……）
|
||||
- 姓氏池：32 个常用修仙风单姓（林、苏、叶、萧、顾、沈、楚、白……）
|
||||
- 名用字池：24 个（清、玄、墨、尘、风、澜、霜、珏……）
|
||||
- 规则：随机 1 个姓 + 1~2 个字（50% 概率双字名）
|
||||
- 不保证唯一（同名弟子可共存，以 id 区分）
|
||||
@@ -84,9 +84,10 @@
|
||||
|
||||
### 3. 灵根
|
||||
|
||||
- 普通弟子：数量 1~3 根均匀随机，元素从五行中随机抽取、互不重复
|
||||
- 普通弟子：数量按配置权重随机（`root_count_weights`，1~5 根），元素从五行中随机抽取、概率均等、互不重复
|
||||
- 天灵根：仅天骄资质再判（概率 `heavenly_root_chance`），灵根数量固定 1 根，修炼速度额外 +50%
|
||||
- 含义：单灵根修炼最快，三灵根最慢（对应修仙世界观）
|
||||
- 含义：单灵根修炼最快，五灵根最慢（对应修仙世界观）
|
||||
- 无灵根暂不生成（体修路线预留，见修炼系统设计）
|
||||
|
||||
### 4. 资质（入宗分流）
|
||||
|
||||
@@ -112,7 +113,7 @@
|
||||
招募**不是玩家随时点按钮**，而是"生成候选 → 暂停时间 → 弹窗选择"：
|
||||
|
||||
- **开局招募**：新游戏开始，生成 **5 名候选**，暂停时间弹窗，**必须选满 3 名**才能确定
|
||||
- **定期招募**：每满间隔（配置文件 `recruit_interval_years`，默认 0.1 年 = 36 天）生成 **3 名候选**，暂停时间弹窗
|
||||
- **定期招募**：每满间隔（配置文件 `recruit_interval_years`，当前 0.25 年 = 90 天）生成 **3 名候选**，暂停时间弹窗
|
||||
- **选择方式**：每个候选独立勾选"入宗"，可全部接受、可全部拒绝（定期招募可 0~3 个）
|
||||
- **结算**：点"确定" → 勾选的入宗、未勾选的拒绝 → 关闭弹窗 → **恢复时间**
|
||||
- 所有参数（候选数、必选数、间隔）来自 `resources/game_config.cfg`，改配置即改难度
|
||||
@@ -161,9 +162,10 @@
|
||||
difficulty="normal" ; 当前难度档位
|
||||
opening_applicant_count=5 ; 开局候选人数
|
||||
opening_pick_count=3 ; 开局必须选满数
|
||||
recruit_interval_years=0.1 ; 定期招募间隔（游戏年）
|
||||
recruit_interval_years=0.25 ; 定期招募间隔（游戏年）
|
||||
recruit_applicant_count=3 ; 定期弹窗候选人数
|
||||
heavenly_root_chance=0.5 ; 天灵根概率：仅天骄资质中再掷，50%
|
||||
root_count_weights=[20, 20, 20, 20, 20] ; 灵根数量权重（1根~5根，和=100 即百分比概率）
|
||||
|
||||
[recruitment_normal] ; 普通难度资质权重（下品/中品/上品/天骄）
|
||||
aptitude_weights=[45, 35, 15, 5]
|
||||
@@ -225,7 +227,7 @@ aptitude_weights=[60, 30, 8, 2]
|
||||
| 元素 | 说明 |
|
||||
|------|------|
|
||||
| 标题 | 弟子姓名 + 天灵根标记 |
|
||||
| 信息区 | 静态展示：资质 / 年龄 / 灵根 / 境界 / 编号 / **入宗时间** |
|
||||
| 信息区 | 静态展示：名字 / 资质 / 年龄 / 灵根 / 境界 / **入宗时间** |
|
||||
| 预留区 | 修炼进度、属性面板等 D5+ 扩展位置（本期留白） |
|
||||
| 底部 | "关闭"按钮 |
|
||||
|
||||
@@ -262,7 +264,7 @@ src/UI/Panels/DisciplesPanel/
|
||||
- [ ] 点顶部"管理"按钮弹出弟子名录面板，显示当前已入宗弟子
|
||||
- [ ] 列表每行显示：姓名 / 资质（天灵根有标记）/ 灵根 / 境界
|
||||
- [ ] 名录为空时显示"暂无弟子"；招募入宗后列表实时刷新
|
||||
- [ ] 点条目"详情"弹出详情弹窗，显示姓名/资质/年龄/灵根/境界/编号
|
||||
- [ ] 点条目"详情"弹出详情弹窗，显示名字/资质/年龄/灵根/境界/入宗时间
|
||||
- [ ] 关闭详情回到列表，关闭列表回到游戏，无报错
|
||||
- [ ] 打开面板期间时间**暂停**，关闭面板后时间恢复推进
|
||||
|
||||
@@ -284,8 +286,8 @@ src/UI/Panels/DisciplesPanel/
|
||||
- [ ] **开局**：进入游戏即暂停，弹出"弟子入宗（开局招募）"，显示 5 名候选
|
||||
- [ ] 开局模式确定按钮在选满 3 名前不可用；选满后可确定
|
||||
- [ ] 确定后：勾选的 3 名入宗（控制台打印），时间恢复推进
|
||||
- [ ] **定期**：每 36 游戏日（0.1 年 @1x ≈ 18 秒）再次暂停弹窗，显示 3 名候选
|
||||
- [ ] **定期**：每 90 游戏日（0.25 年 @1x ≈ 45 秒）再次暂停弹窗，显示 3 名候选
|
||||
- [ ] 定期模式可勾选 0~3 名，全部拒绝也可确定；时间正常恢复
|
||||
- [ ] 多次招募后能观察到天灵根弟子（约 3% 概率，弹窗/控制台有标记）
|
||||
- [ ] 多次招募后能观察到天灵根弟子（仅天骄中再判 50%，总体概率约 2.5%，弹窗/控制台有标记）
|
||||
- [ ] 修改 `game_config.cfg` 中 `opening_applicant_count` 等参数，重启后开局候选数随之变化
|
||||
- [ ] 返回主菜单再进入，名录已清空（reset 生效）
|
||||
|
||||
Reference in New Issue
Block a user