33 lines
3.9 KiB
Markdown
33 lines
3.9 KiB
Markdown
# 节点奖励屏 UX spec（node-reward）
|
||
|
||
> 状态：v2.0（2026-10-01 迭代 10 追加批重写——用户拍板：奖励节点三选一与通关三选一**共享同池**；原「魔法道具投放渠道」过渡形态退役）
|
||
> 事实源：`game/presentation/views/bonus_pick_overlay.gd`（三选一覆盖层共用面）+ `main.gd`（奖励节点分支——`adventure.node_bonus_candidates/apply_node_bonus`）+ `battle_narrator.gd`（node_bonus_header）
|
||
> 相邻：[level-clear](level-clear.md)（通关三选一面——同一覆盖层的另一上下文）/ [level-map](level-map.md)（关卡画面）/ [魔法道具](../systems/排雷循环/魔法道具.md)（道具件内容权威）/ [冒险结构](../systems/冒险循环/冒险结构.md)（提升池单例与次数上限）
|
||
|
||
## 定位
|
||
|
||
奖励节点（reward node）到达即开的**提升三选一选择面**：与通关三选一共享同一提升池（六种：攻击/生命上限/护甲/GP 袋/魔法道具/行动点件）——同权重、同全冒险次数上限、同 reward_pick 封闭流。与通关面的差异仅在上下文：无部分回血、无钥石增量行，兑付后「继续」回图选路（不推进关卡）。
|
||
|
||
## 布局与交互
|
||
|
||
- 载体 = 提升三选一覆盖层（BonusPickOverlay，与 [level-clear](level-clear.md) 共用组件——零新增交互原语）。
|
||
- 头部行：「关卡奖励点 / 从提升池抽三选一（与通关三选一同池同权重同上限）：选择一件带走：」（Narrator.node_bonus_header）。
|
||
- 三卡点选（✓ 高亮，确认前可改选）→「确认选择」→ 兑付反馈（选中件效果 + 丢弃提示）→「继续」→ 回图选路（零自动推进同款）。
|
||
- **魔法道具件直显具体道具**（掷定前置，v2.1）：候选抽定时即掷定具体道具，卡片显示「魔法道具 / 探巢摆钟 · 真视 3×3」——不再是「随机获得一件」盲选。
|
||
- 魔法道具件满位：替换子面板（现有库存件 + 新件 N+1 选 N，丢旧收新 / 放弃新件两路——与通关面同构；丢弃目标 = 关卡域库存件句柄）。
|
||
|
||
## 口径
|
||
|
||
- **同池同上限**：件获取次数计数为冒险级单例——奖励节点与通关三选一两渠道合计判上限（达上限件在两渠道同样剔牌库）；权重与牌库口径读冒险表（registry adventure_table 为准）。
|
||
- 道具件入**本关库存**（即时可用，来源归因 `reward_node`）——区别于通关三选一的跨关携带（清库后授予、下一关生效）。
|
||
- 「池空直通」合法态随共享池退役：池含无次数上限的 GP/道具件，牌库恒非空。
|
||
- 退役件（探宝罗盘）/失义件不入道具件随机池（同调位约束口径不变，归[魔法道具](../systems/排雷循环/魔法道具.md)）。
|
||
|
||
## 版本历史
|
||
|
||
| 版本 | 日期 | 改动 |
|
||
|---|---|---|
|
||
| v1.0 | 2026-09-29 | 迭代 7 T5 随批出生（三选一构筑点形态——用户拍板②丙） |
|
||
| v2.0 | 2026-10-01 | **共享池改写（迭代 10 追加批——用户拍板「奖励节点与通关三选一相同、共享同一个池子」）**：①定位改提升三选一选择面（六种共享池、同权重同次数上限、同 reward_pick 流）；②载体改 BonusPickOverlay 共用面（原 node_overlay 道具三选一面退役）；③道具件满位升级为替换子交互两路（原过渡形态=满位不授予）；④「池空直通」合法态退役（牌库恒非空）；⑤道具件入本关库存（即时可用），区别于通关渠道的跨关携带 |
|
||
| v2.1 | 2026-10-01 | **掷定前置（目检反馈批——用户反馈「抽到魔法道具不显示详情不直观」，推荐案获批）**：道具件具体道具随候选抽定（reward_pick 流序内挪，消费数不变），卡片直显「魔法道具 / 道具名 · 效果摘要」；断点停点快照随载 aux_detail（续玩卡片详情不丢）；node_bonus_candidates 返回扩 dict {candidates, aux_detail} |
|