230 lines
12 KiB
GDScript
230 lines
12 KiB
GDScript
# VERTICAL SLICE - NOT FOR PRODUCTION
|
||
# 实现 GDD：design/ux/battle.md（四区呈现装配器）——读核心只读面（战斗结算 呈现快照 / runner）→
|
||
# 组装文案/投影 → 驱动各视图 setter。
|
||
# 高内聚边界："核心状态 → 呈现文案"的全部翻译集中于此；视图保持零核心依赖；
|
||
# 静态无状态——呈现不持久化任何核心句柄。
|
||
# E1 封装收口（2026-09-13）：核心状态读取统一经 战斗结算.presentation_snapshot() 成文快照面——
|
||
# 禁再链式穿透 settlement.enemy_system.hero / settlement.enemy_system.enemies / settlement.status_effects.query_active 一类路径（战斗结算 协作对象已私有化，
|
||
# 敌人含死亡残位的投影由快照 enemies[] 承载，含 alive/pending_*/effects 字段——2026-09-16 敌人技能池批批 2 定稿）。
|
||
# 更新触发注记（battle.md Data Requirements）：旗/拔/移动成功反馈零事件外发（排雷玩法 发射面封闭）——
|
||
# 经 ActionOutcome 返回值命令式驱动；AP/RAP 无推送信号——组合根每次调用返回后重查；
|
||
# 增益状态 纯被动容器零信号——状态栏刷新绑 战斗结算 结算编排完成时点。
|
||
# Date: 2026-09-12（战斗屏改造批；基础 = 2026-09-11 HUD 装配器；2026-09-13 快照面改造）
|
||
class_name HudPresenter
|
||
extends RefCounted
|
||
|
||
|
||
# 每次结算行/轮次/节点变化/动作返回后调用（组合根全量重查装配）
|
||
# 2026-09-26 C 区精简批：钱包 GP/钥石投喂退役（中/大循环资源迁出战斗屏——信息归属拍板）；
|
||
# HP/状态效果单投喂 B 区站桩（原 B/C 双投喂为重复展示——信息归属拍板单一展示面原则）
|
||
static func refresh(stage: BattleStageView, info: HeroInfoPanelView, ap_bar: ApBarView,
|
||
settlement, runner, level_active: bool, db, refresh_remaining: int) -> void:
|
||
# 本关强化列表（v3.5 迭代 9 卡⑫ 2026-09-30——runner 统一加算区投影：商店购买与关卡大奖励
|
||
# 共账本〔level_runner bonus{atk,max_hp,armor_class}〕；空加算=整节隐藏〔视图内空态纪律〕。
|
||
# 呈现只读投影零核心触碰；行文格式=代拍板白名单项）
|
||
if runner != null and level_active:
|
||
var b: Dictionary = runner.bonus
|
||
var lines: Array[String] = []
|
||
if int(b.get("atk", 0)) != 0:
|
||
lines.append("攻击 %+d" % int(b.get("atk", 0)))
|
||
if int(b.get("max_hp", 0)) != 0:
|
||
lines.append("生命上限 %+d" % int(b.get("max_hp", 0)))
|
||
if int(b.get("armor_class", 0)) != 0:
|
||
lines.append("护甲 AC %+d" % int(b.get("armor_class", 0)))
|
||
info.set_level_bonuses(lines)
|
||
else:
|
||
info.set_level_bonuses([])
|
||
# 流派件持有投影（迭代 12 呈现补齐 2026-10-04——用户反馈「局内奖励选了什么看不到」：
|
||
# 逐流派聚合行+成型档位；常驻可读+空态隐藏。档位求值=RelicsEngine 纯函数直调）
|
||
if runner != null and level_active:
|
||
info.set_relic_holdings(relic_holdings_lines(db, runner.relics_held()))
|
||
else:
|
||
info.set_relic_holdings([])
|
||
if settlement == null:
|
||
info.set_board_variants([]) # 战斗域角标出战斗即隐（首发批 2026-10-04——空态纪律）
|
||
_refresh_out_of_battle(stage, info, ap_bar, runner, level_active, db)
|
||
return
|
||
var s: Dictionary = settlement.presentation_snapshot()
|
||
# 地形变异常驻角标投影（全局作用域变异首发批 2026-10-04——板级变异快照 → 文案行；
|
||
# 空态隐藏=流派件段先例；战斗全程常驻防中局遗忘）
|
||
info.set_board_variants(board_variant_lines(db, s.get("board_variants", [])))
|
||
var hero: Dictionary = s.hero
|
||
if hero.is_empty() or not bool(hero.get("alive", false)):
|
||
_refresh_out_of_battle(stage, info, ap_bar, runner, level_active, db)
|
||
return
|
||
_refresh_hero(stage, info, s)
|
||
_refresh_economy(ap_bar, s, db, refresh_remaining)
|
||
stage.set_enemies(s.enemies)
|
||
|
||
|
||
# ---- B 区主角站桩（HP/状态唯一展示面）+ C 区数据框（攻击/AC） ----
|
||
|
||
static func _refresh_hero(stage: BattleStageView, info: HeroInfoPanelView, s: Dictionary) -> void:
|
||
var hero: Dictionary = s.hero
|
||
var hp: int = int(hero.hp)
|
||
var max_hp: int = int(hero.max_hp)
|
||
var atk: int = int(hero.atk)
|
||
# 修正 = attack_up 池有效值（hero_offense）；来源角标 = 效果 display_name（快照 hero_effects 投影）
|
||
var mod_total := 0
|
||
var sources: Array[String] = []
|
||
for eff in s.hero_effects:
|
||
if String(eff.effect_id) == "attack_up":
|
||
mod_total += int(eff.effective_value)
|
||
sources.append("%s×%d" % [String(eff.display_name), int(eff.layers)])
|
||
var mod_text := ""
|
||
if mod_total != 0:
|
||
mod_text = "(%+d%% %s)" % [mod_total, "·".join(sources)]
|
||
# B 区站桩 = HP 与状态效果唯一展示面（2026-09-26 信息归属拍板）——C 区不再重复投喂
|
||
stage.hero_standee.set_hero(hp, max_hp)
|
||
stage.hero_standee.set_effects(s.hero_effects)
|
||
info.set_attack(atk, mod_text)
|
||
# 我方 AC 唯一展示面 = C 区（2026-09-26 二轮拍板补入）——快照 armor_class 含战斗内 ac_up 折算
|
||
info.set_armor(int(hero.get("armor_class", 0)))
|
||
|
||
|
||
# ---- 行动经济（AP 点阵 / RAP / 弃图刷新按钮态——RAP 读数 2026-09-26 自 C 区迁入本条） ----
|
||
|
||
static func _refresh_economy(ap_bar: ApBarView, s: Dictionary, db, refresh_remaining: int) -> void:
|
||
ap_bar.set_ap(int(s.ap), int(db.action_economy.ap_per_round))
|
||
ap_bar.set_rap(int(s.rap))
|
||
var digging := String(s.phase) == ActionEconomy.PHASE_ACTIVE
|
||
ap_bar.set_refresh_state(refresh_remaining,
|
||
bool(s.can_refresh) and digging) # Waiting 代理已随 OQ12 退役——UI 仅挖掘期受理
|
||
ap_bar.set_stop_enabled(bool(s.hero.get("alive", false)) and digging)
|
||
|
||
|
||
# 流派件持有聚合文案（迭代 12 呈现补齐——战斗 C 区与关卡选择页两处共用；空持有=空数组）
|
||
static func relic_holdings_lines(db, held: Array) -> Array[String]:
|
||
var rlines: Array[String] = []
|
||
if db == null or db.relics == null or (db.relics.rows as Array).is_empty() or held.is_empty():
|
||
return rlines
|
||
var arch_names := {"magic": "魔法", "pierce": "穿刺", "normal": "普攻", "dig": "开格",
|
||
"flag": "标旗", "charge": "蓄力", "devour": "吞噬"}
|
||
var counts := {}
|
||
for rid in held:
|
||
var rrow: Dictionary = db.relic_row(String(rid))
|
||
var arch := String(rrow.get("archetype", ""))
|
||
counts[arch] = int(counts.get(arch, 0)) + 1
|
||
var tiers: Dictionary = RelicsEngine.tiers_for(held, db.relics)
|
||
for arch in counts.keys():
|
||
var tier := int(tiers.get(arch, 0))
|
||
var tier_text := "档二" if tier >= 2 else ("档一" if tier == 1 else "散件")
|
||
rlines.append("%s ×%d · %s" % [String(arch_names.get(String(arch), String(arch))), int(counts[arch]), tier_text])
|
||
return rlines
|
||
|
||
|
||
# 地形变异常驻角标文案（全局作用域变异首发批 2026-10-04——板级变异 id → 文案行；
|
||
# 空集 = 空数组=空态隐藏。三行制：变异名+两行效果说明（C 区 240px 宽防裁切）。
|
||
# 文案 2026-10-04 用户人闸反馈常规化修订（原俚语表述退役）
|
||
static func board_variant_lines(db, ids: Array) -> Array[String]:
|
||
var lines: Array[String] = []
|
||
if db == null or db.variation == null:
|
||
return lines
|
||
for vid in ids:
|
||
var row: Dictionary = db.variation.row_by_id(String(vid))
|
||
if not row.is_empty():
|
||
lines.append(String(row.get("display_name", vid)))
|
||
lines.append("回复与护甲资源减少")
|
||
lines.append("攻击资源增多")
|
||
return lines
|
||
|
||
|
||
# ---- 战斗收尾反馈与结算视觉同步（T3 HUD 单通道批 2026-10-02——组合根直改视图收敛入此） ----
|
||
|
||
# battle_over 收尾反馈：死亡兜底灰化 → 主角态回 idle → RAP 清零脉冲（调试收尾路）→ 状态全清可见反馈。
|
||
# 调试/冒险两路共用；reset_rap=false = 冒险收束（RAP 清零由战斗末拍已毕，收束拍不再重放脉冲）。
|
||
static func battle_end_feedback(stage: BattleStageView, ap_bar: ApBarView, reset_rap: bool) -> void:
|
||
stage.gray_all_enemies() # 死亡兜底：站桩灰化残位（禁瞬消语义的战斗收尾面）
|
||
stage.settle_hero_idle() # 主角态回 idle（迭代 6 T3 三态收尾）
|
||
if reset_rap:
|
||
ap_bar.set_rap(0) # RAP 清零脉冲 + 微文案（载体 2026-09-26 迁 D 区 AP 条）
|
||
stage.hero_standee.set_effects_cleared_feedback() # 状态全清可见反馈（增益状态×4④——载体迁 B 区站桩）
|
||
|
||
|
||
# 结算阶段视觉同步（round_end → 下一轮）：D 区去饱和 + 禁挖光 + 明细带 settle/dig 换挡 + 轮次文案。
|
||
# 光带演出（play_round_sweep）属时序敏感触发，留在组合根（上升沿检测随行）——本条只做态驱动 setter。
|
||
static func sync_settlement_visuals(stage: BattleStageView, board_view: BoardView,
|
||
log_view: BattleLogView, settling: bool, phase_text: String) -> void:
|
||
board_view.set_desaturated(settling)
|
||
board_view.set_dig_glow_enabled(not settling)
|
||
stage.set_settle_focus(settling)
|
||
log_view.set_mode("settle" if settling else "dig")
|
||
stage.set_round_text(phase_text)
|
||
|
||
|
||
# 战斗外（节点间隙/关卡结束）——HP 读 runner 携带值
|
||
static func _refresh_out_of_battle(stage: BattleStageView, info: HeroInfoPanelView,
|
||
ap_bar: ApBarView, runner, level_active: bool, db) -> void:
|
||
if not level_active:
|
||
return
|
||
if runner != null:
|
||
info.set_attack(runner.effective_atk(), "（关卡推进中）")
|
||
info.set_armor(runner.effective_ac())
|
||
stage.hero_standee.set_hero(runner.hero_hp, runner.effective_max_hp())
|
||
stage.hero_standee.set_effects([])
|
||
stage.clear_enemies() # 节点间隙清敌方站桩残位（死亡瞬间的灰化呈现已在结算行驱动完成）
|
||
ap_bar.set_rap(0) # battle_over RAP 清零反馈（行动经济 义务——载体 2026-09-26 迁 AP 条）
|
||
|
||
|
||
# 三源拒绝可感知（排雷玩法 reject_reason/sub_reason → 玩家文案；pattern 1 双源拒绝反馈）
|
||
static func outcome_text(outcome: Dictionary) -> String:
|
||
if outcome.accepted:
|
||
return "执行完成。"
|
||
match String(outcome.get("reject_reason", "")):
|
||
"board_face":
|
||
var sub := String(outcome.get("sub_reason", ""))
|
||
var texts := {
|
||
"not_adjacent": "不能执行：目标与小人不相邻",
|
||
"target_revealed": "不能执行：目标已开",
|
||
"target_concealed": "不能移动：目标未开",
|
||
"flag_present": "不能插旗：此格已有旗（旗为一次性承诺——相邻时左键直接挖开）",
|
||
"no_path": "不能移动：已探明区不连通",
|
||
"out_of_catalog": "无效目标",
|
||
}
|
||
return texts.get(sub, "棋盘面拒绝: " + sub)
|
||
"resource_face":
|
||
return "AP 不足。"
|
||
"phase":
|
||
return "结算中，非行动阶段。"
|
||
"board_invalid":
|
||
return "棋盘数据非法（fail-fast）。"
|
||
_:
|
||
return "动作被拒。"
|
||
|
||
|
||
# ---- 调整板批量模拟报告装配（文案归 presenter——视图只 set_text；code-review 2026-09-12 批） ----
|
||
|
||
static func tune_sim_report(n: int, atk_pct: int, hp_pct: int, wins: int, dmg_all: Array, hp_left_win: Array, hp_boss: Array, rounds_all: Array, death_nodes: Dictionary, base_hp: int) -> String:
|
||
var lines: Array[String] = []
|
||
lines.append("[b]模拟 N=%d（atk+%d%% / hp+%d%%）[/b]" % [n, atk_pct, hp_pct])
|
||
lines.append("通关率 [color=#%s]%.0f%%[/color]（%d/%d）" % [UiKit.HEX_LOG_WIN, 100.0 * float(wins) / float(maxi(1, n)), wins, n])
|
||
lines.append("整关承伤：均 %.1f · p90 %.0f（基础 HP %d）" % [_mean(dmg_all), _p90(dmg_all), base_hp])
|
||
if not hp_left_win.is_empty():
|
||
lines.append("通关剩余 HP 均 %.1f · 进 Boss HP 均 %.1f" % [_mean(hp_left_win), _mean(hp_boss)])
|
||
lines.append("平均轮数 %.1f" % _mean(rounds_all))
|
||
if death_nodes.is_empty():
|
||
lines.append("败北节点：—")
|
||
else:
|
||
var parts: Array[String] = []
|
||
for k in death_nodes.keys():
|
||
parts.append("%s×%d" % [k, death_nodes[k]])
|
||
lines.append("败北节点：%s（0-3=战斗序，4=Boss）" % " ".join(parts))
|
||
return "\n".join(lines)
|
||
|
||
|
||
static func _mean(a: Array) -> float:
|
||
if a.is_empty():
|
||
return 0.0
|
||
var t := 0.0
|
||
for v in a:
|
||
t += float(v)
|
||
return t / a.size()
|
||
|
||
|
||
static func _p90(a: Array) -> float:
|
||
if a.is_empty():
|
||
return 0.0
|
||
var b := a.duplicate()
|
||
b.sort()
|
||
return float(b[mini(b.size() - 1, int(0.9 * b.size()))])
|