4.7 KiB
4.7 KiB
节点奖励屏 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-map（关卡画面）/ 魔法道具（道具件内容权威）/ 冒险结构（提升池单例与次数上限）
定位
奖励节点（reward node）到达即开的提升三选一选择面：与通关三选一共享同一提升池（六种：攻击/生命上限/护甲/GP 袋/魔法道具/行动点件）——同权重、同全冒险次数上限、同 reward_pick 封闭流。与通关面的差异仅在上下文：无部分回血、无钥石增量行，兑付后「继续」回图选路（不推进关卡）。
布局与交互
- 载体 = 提升三选一覆盖层（BonusPickOverlay，与 level-clear 共用组件——零新增交互原语）。
- 头部行：「关卡奖励点 / 从提升池抽三选一（与通关三选一同池同权重同上限）：选择一件带走：」（Narrator.node_bonus_header）。
- 三卡点选（✓ 高亮，确认前可改选）→「确认选择」→ 兑付反馈（选中件效果 + 丢弃提示）→「继续」→ 回图选路（零自动推进同款）。
- 魔法道具件直显具体道具（掷定前置，v2.1）：候选抽定时即掷定具体道具，卡片显示「魔法道具 / 探巢摆钟 · 真视 3×3」——不再是「随机获得一件」盲选。
- 魔法道具件满位：替换子面板（现有库存件 + 新件 N+1 选 N，丢旧收新 / 放弃新件两路——与通关面同构；丢弃目标 = 关卡域库存件句柄）。
口径
- 同池同上限：件获取次数计数为冒险级单例——奖励节点与通关三选一两渠道合计判上限（达上限件在两渠道同样剔牌库）；权重与牌库口径读冒险表（registry adventure_table 为准）。
- 道具件入本关库存（即时可用，来源归因
reward_node）——区别于通关三选一的跨关携带（清库后授予、下一关生效）。 - 「池空直通」合法态随共享池退役：池含无次数上限的 GP/道具件，牌库恒非空。
- 退役件（探宝罗盘）/失义件不入道具件随机池（同调位约束口径不变，归魔法道具）。
版本历史
| 版本 | 日期 | 改动 |
|---|---|---|
| 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} |
| v2.2 | 2026-10-03 | 三档位令牌池（用户全裁——待 M-4 数值批实施，现行 v2.1 平铺池维持到实施）：池改固定配额令牌池（普通 70/稀有 25/罕见 5=100 张；洗牌不放回抽 3、选中踢池未选回池、池耗即枯竭）；档位构成=普通〔小GP 18/小增伤 18/小护甲 17/小生命 17〕+稀有〔大GP/大增伤/大护甲/大生命/恢复 各 5〕+罕见〔AP 3/道具 2〕；数值对 20/50、+1/+2、+1/+2、+5/+10、恢复+6、AP+1、道具 1 件；种类次数上限退役（池消耗即上限；同调位上限保留）；恢复件=新入池种类；MC 策略改判 1 级最稀有/2 级最左（确定性）——设计全稿与执行口径见 06 待办「奖励池三档位令牌池重设计」条；卡片呈现面（本 spec 交互节）零改动 |