拆件批v1.3-B1(主角账领域拆分): hero_ledger.gd 整件退役→三新件按领域各归各账——hero_stats.gd(生命/特性/类型轴/生效公式与回血封顶单点/续玩钳制收口 clamp_hp_to_resume_cap/断点片段 hero_hp+relics 两键,构造注入 GainJournal 只读引用消费加算汇总)、gp_wallet.gd(gp 单写原语+片段 gp 键)、gain_journal.gd(获得记录三层+三通道 gain_bonus 单写原语+购买档数/钥石/真视+reset_adventure_accounts+片段六键,record_gain 转私有,_record_gain 词表不变);断点拼盘改三片段并集(BREAKPOINT_FIELDS 28 键序不变,_resume_ledger 三还原各取各键,日记缺键汇总直载/在档推导比对拒载逐字承现);消费方改址——adventure_runner(建件三引用+件出口 hero()→stats()/wallet()/journal()/deck(),start/restart 三件先日记后钱包再置满同序,_resume_params 钳制改 clamp_hp_to_resume_cap,载荷_base 随附钱包读数——停点件零钱包依赖)、level_runner(ctx hero→stats/wallet/journal 三键,私有三件同源成对自建,gp/hero_hp 属性改指三件,effective_ap_bonus→journal,hero()→stats()+journal() 出口,_bind_shop refs 换代)、shop_session(refs wallet+journal,BONUS_AXES 归 GainJournal)、battle_orchestrator(encounter "hero"→"journal" 键+_hero 类型 GainJournal)、curio_stop(构造参 stats+journal,兑付落账 split 指针,头注换代清 HeroLedger 表述)、呈现/探针/模拟六文件 12 处读面改址、测试六文件改址(hero_ledger_test 重写为三件测试——文件名与 manifest 行不变,新增 hs1 零引用源码断言)。验收:全量套件除 round_flow EV 锚 goblin 已知预期红外全绿;bp 对拍 292dumps×28 键 mismatch=0;冒烟 17 项 0 失败〔领域拆分批 V1〕
This commit is contained in:
DKChan committed
1 parent
e40aa6f8c1
commit
fde14f1c1c
28 files changed
+679
-532
No files matched your search
+51
-36
@@ -5,7 +5,7 @@
|
||||
## 调试浮窗百分比通道单点归主角账（set_hero_override 转调——公式消费面同源）。
|
||||
## 信号顺序契约：呈现层须在 level_started 回调重取 runner 实例，choices_presented 才不会被空防御丢弃。
|
||||
## 关卡开始信号前零发射：本件全部信号在 level_started 发射前保持静默（构造与 start 收参零信号——
|
||||
## defer_entry 两步式以 level_started 为界，先广播后呈现入口候选；配断言面见冒烟源码断言〔拆件批 V5〕）。
|
||||
## defer_entry 两步式以 level_started 为界，先广播后呈现入口候选；配断言面见冒烟源码断言）。
|
||||
class_name LevelRunner
|
||||
extends RefCounted
|
||||
|
||||
@@ -27,18 +27,20 @@ var node_index := -1
|
||||
var level_counters: Dictionary[Variant, Variant] = {} # 关卡桶（lvl_ 前缀计数器；每关随 LevelRunner new 天然空＝按关清零，替代旧硬编码清除名单）
|
||||
var _rest_handler: Callable # 治疗封顶回报执行体（默认内置 rest_heal_amount；冒险模式 = AdventureRunner.apply_rest——接口③）
|
||||
var _external := false # 冒险模式标记（钱包收束时机与播种语义分叉点）
|
||||
# 主角账引用（拆件批 T1 过渡面：冒险模式经 set_hero 注入共享实体账、单关模式 _init 自建私有账；
|
||||
# 构造注入收口归 T3 ctx 面——后置 setter 随构造注入一并退役）
|
||||
var _hero: HeroLedger = HeroLedger.new(null, {}) # 直构缺省私有账（db 随 _init 补）
|
||||
# 主角账三件引用（领域拆分批三件化：冒险模式经 ctx 注入共享三件、单关模式 _init 自建私有件；
|
||||
# 数值账消费日记汇总——私有默认件同源成对建）
|
||||
var _journal: GainJournal
|
||||
var _wallet: GpWallet
|
||||
var _stats: HeroStats
|
||||
var loadout = null # 同调配装件（构造注入；直构=单关零件）
|
||||
var _adv_bucket: Dictionary[Variant, Variant] = {} # 冒险桶（效果引擎 adv_ 计数器宿主字典——冒险模式随 hero 注入；单关=本实例自有）
|
||||
# hero_hp / gp 属性化（既有读写点零改动——值类型经属性落主角账）
|
||||
var _adv_bucket: Dictionary[Variant, Variant] = {} # 冒险桶（效果引擎 adv_ 计数器宿主字典——冒险模式随 ctx 注入；单关=本实例自有）
|
||||
# hero_hp / gp 属性化（既有读写点零改动——值类型经属性落主角账三件）
|
||||
var hero_hp: int:
|
||||
get: return _hero.hero_hp
|
||||
set(v): _hero.hero_hp = v
|
||||
get: return _stats.hero_hp
|
||||
set(v): _stats.hero_hp = v
|
||||
var gp: int: # GP 冒险钱包（局内货币——冒险开始 = 0、收束清零；不入存档不入摘要）
|
||||
get: return _hero.gp
|
||||
set(v): _hero.gp = v
|
||||
get: return _wallet.gp
|
||||
set(v): _wallet.gp = v
|
||||
var _shop: ShopSession = null # 商店件（_init 建；双模式货架/定价/购买/刷新唯一宿主）
|
||||
# 协作对象私有（E1/E3 封装收口）：settlement 读取经 current_battle() 成文出口
|
||||
var _settlement: BattleOrchestrator = null # 当前战斗编排器（关卡结束置 null）
|
||||
@@ -60,10 +62,10 @@ var visited: Array[Dictionary] = [] # 已兑付/到达节点
|
||||
var _generator # 参数化长图生成器（惰性建——NodeMapGenerator 持注入的 RngService）
|
||||
|
||||
|
||||
# 构造注入一次给齐（拆件批 T3——后置 setter 群与商店重绑机制退役；_bind_shop 全仓仅本处构造调用）。
|
||||
# 构造注入一次给齐（后置 setter 群与商店重绑机制退役；_bind_shop 全仓仅本处构造调用）。
|
||||
# ctx 键（冒险模式由 AdventureRunner._start_current_level 组包；缺省空字典 = 单关测试模式：
|
||||
# 私有主角账自建〔空 override〕、充能账瘦壳自建、冒险桶本实例自有、pool 模式零注入）：
|
||||
# hero:HeroLedger（共享主角账——活引用）／loadout:AttuneLoadout（同调配装件）／adv_bucket:Dictionary（冒险桶宿主字典）
|
||||
# 私有主角账三件自建〔空 override、数值账同源消费私有日记〕、冒险桶本实例自有、pool 模式零注入）：
|
||||
# stats:HeroStats／wallet:GpWallet／journal:GainJournal（共享主角账三件——活引用）／loadout:AttuneLoadout（同调配装件）／adv_bucket:Dictionary（冒险桶宿主字典）
|
||||
# attunement:Array（同调装配集——活引用）／tree_rules:Array（树 rule 键集——活引用）／shop_mode:String（"pool" 才注入池面）
|
||||
# treasure_unlocked:Dictionary／hero_attack_type:String／hero_armor_type:String
|
||||
# voucher_rap:int／voucher_time_sand:int（凭证出箱注入面）
|
||||
@@ -71,11 +73,16 @@ var _generator # 参数化长图生成器（惰性建——NodeMapGenerator
|
||||
func _init(db_ref: ConfigDb, rng_ref: RngServiceCore, ctx: Dictionary = {}) -> void:
|
||||
db = db_ref
|
||||
rng = rng_ref
|
||||
if ctx.get("hero", null) is HeroLedger:
|
||||
_hero = ctx["hero"]
|
||||
_feats = _hero.feats # 特性集活引用注入（关内兑付 relic 当关生效——契约 6）
|
||||
if ctx.get("stats", null) is HeroStats:
|
||||
_stats = ctx["stats"]
|
||||
_wallet = ctx["wallet"] if ctx.get("wallet", null) is GpWallet else GpWallet.new()
|
||||
_journal = ctx["journal"] if ctx.get("journal", null) is GainJournal else GainJournal.new()
|
||||
_feats = _stats.feats # 特性集活引用注入（关内兑付 relic 当关生效——契约 6）
|
||||
else:
|
||||
_hero.db = db # 直构私有账补表引用（单关模式——实例不重建，值重置走 start_level）
|
||||
_journal = GainJournal.new() # 直构私有三件（单关模式——实例不重建，值重置走 start_level）
|
||||
_wallet = GpWallet.new()
|
||||
_stats = HeroStats.new(null, {}, _journal)
|
||||
_stats.db = db # 直构私有账补表引用（单关模式——实例不重建，值重置走 start_level）
|
||||
var loadout_ref: Variant = ctx.get("loadout", null)
|
||||
loadout = loadout_ref if loadout_ref is AttuneLoadout else null # 直构=单关零 loadout（充能面跳过）
|
||||
if ctx.get("adv_bucket", null) is Dictionary:
|
||||
@@ -105,31 +112,31 @@ func _is_running() -> bool:
|
||||
# ---- 测试面板覆盖（模拟天赋树属性提升——仅测试用，正式侧归 元进度；经 encounter 传入战斗）----
|
||||
|
||||
func set_hero_override(atk_pct: int, hp_pct: int) -> void:
|
||||
_hero.set_debug_override(atk_pct, hp_pct)
|
||||
_stats.set_debug_override(atk_pct, hp_pct)
|
||||
|
||||
|
||||
# 生效公式单点归主角账（拆件批 T1——本类删公式本体，读面转调；叠加次序注释随公式迁主角账）
|
||||
# 生效公式单点归数值账（本类删公式本体，读面转调；叠加次序注释随公式迁数值账）
|
||||
func effective_atk() -> int:
|
||||
return _hero.effective_atk()
|
||||
return _stats.effective_atk()
|
||||
|
||||
|
||||
func effective_max_hp() -> int:
|
||||
return _hero.effective_max_hp()
|
||||
return _stats.effective_max_hp()
|
||||
|
||||
|
||||
func effective_ac() -> int:
|
||||
return _hero.effective_ac()
|
||||
return _stats.effective_ac()
|
||||
|
||||
|
||||
# 行动点加成生效值（统一冒险加算区第四轴 ap；经战斗开始入参 hero_ap_bonus
|
||||
# 行动点加成生效值（统一冒险加算区第四轴；经战斗开始入参 hero_ap_bonus
|
||||
# 传入战斗域，兑现 = 每场战斗开始首轮行动点基线 +加成值〔行动经济 GDD 跨冒险行动点加成轴节〕）
|
||||
func effective_ap_bonus() -> int:
|
||||
return maxi(0, _hero.bonus_total("ap"))
|
||||
return maxi(0, _journal.bonus_total("ap"))
|
||||
|
||||
|
||||
# 覆盖复位（关卡结束归零——表值不可变，仅清百分比；调用方兼容保留）
|
||||
func restore_hero_base() -> void:
|
||||
_hero.set_debug_override(0, 0)
|
||||
_stats.set_debug_override(0, 0)
|
||||
|
||||
|
||||
# ---- 关卡生命周期 ----
|
||||
@@ -152,8 +159,10 @@ func start_level(level_index: int, seed_val: int, base_override_in: Dictionary =
|
||||
_phase = Phase.IDLE
|
||||
_candidates = []
|
||||
visited = []
|
||||
_hero.rebase_override(base_override_in) # 永久强化 flat 重注（规范化归主角账——契约同冒险开始参数面）
|
||||
_hero.reset_for_single_level() # 账面值重置（钱包/加算区/已购档/钥石/日记清零＋生命置满——实例不重建，shop 绑定不换代）
|
||||
_stats.rebase_override(base_override_in) # 永久强化 flat 重注（规范化归数值账——契约同冒险开始参数面）
|
||||
_journal.reset_adventure_accounts() # 日记域账面清零（先于置满——生命口径不含加算区）
|
||||
_wallet.clear_wallet() # 钱包清零
|
||||
_stats.reset_for_single_level() # 数值账面重置（override 清零＋生命置满＋特性清零——实例不重建，shop 绑定不换代）
|
||||
rng.new_adventure(seed_val) # 关卡起点 = 冒险起点（切片口径；跨关接续归 冒险结构）
|
||||
if not _assign_generated_graph(row, seed_val):
|
||||
_phase = Phase.ENDED
|
||||
@@ -171,7 +180,7 @@ func start_level(level_index: int, seed_val: int, base_override_in: Dictionary =
|
||||
# 种子域归冒险结构：本路径不重播种；账本归冒险结构：本路径不重置 gp/加算区/已购档，
|
||||
# 也不重置 hero_hp——账本当前值即开局生命，AdventureRunner 已在主角账写好）。
|
||||
# 流程与 start_level 同款（_find_level_row → 生成图装配 → 状态初始化 → _enter_node(入口)），
|
||||
# 差异仅在恢复执行体的注入与零重置（主角账/冒险桶经 set_hero 注入——T1 过渡面，T3 收构造）。
|
||||
# 差异仅在恢复执行体的注入与零重置（主角账三件/冒险桶经 ctx 构造注入）。
|
||||
# defer_entry 尾参（缺省 false = 直接进节点）——true 时不自动
|
||||
# _enter_node(entry)，改置选路态（awaiting_choice + 单候选 = 入口节点），由 AdventureRunner 在
|
||||
# level_started 之后调 present_entry_choice() 呈现、玩家 pick_next_node 显式进首战。拆两步的
|
||||
@@ -302,7 +311,7 @@ func breakpoint_fragment() -> Dictionary[Variant, Variant]:
|
||||
# "visited_ids": Array[int], "aux_items": Array}；空字典 = 既有路径逐位不变）。
|
||||
# 返回 resume_state 形态供 start_level_external 分派（_restore_to_stop / restore_treasure_items）。
|
||||
func restore_fragment(resume_state: Dictionary) -> Dictionary:
|
||||
var aux: Array = resume_state.get("aux_items", []) as Array
|
||||
var aux: Array[Variant] = resume_state.get("aux_items", []) as Array
|
||||
if not aux.is_empty():
|
||||
restore_treasure_items(aux)
|
||||
return resume_state
|
||||
@@ -526,7 +535,7 @@ func _start_battle(node: Dictionary) -> bool:
|
||||
"attack_type": _hero_attack_type, "armor_type": _hero_armor_type, # 两根类型轴（spawn 英雄快照；空串=锻造配置默认值回退）
|
||||
"attunement": _attunement,
|
||||
"loadout": loadout, # 同调配装件下传（充能单源化——reset_cycle/consume_charge 消费面；直构 null=零装配）
|
||||
"hero": _hero, # 主角实体账下传（战末 bonus 汇入/真视计数单写原语消费面）
|
||||
"journal": _journal, # 加算日记下传（战末 bonus 汇入/真视计数单写原语消费面）
|
||||
"adv_bucket": _adv_bucket, # 冒险桶下传（效果引擎 adv_ 计数器宿主字典——跨战持久同一引用）
|
||||
"level_counters": level_counters, # 关卡桶下传（同关跨战共享引用、随本类 new 天然空）
|
||||
"feats": _feats,
|
||||
@@ -661,9 +670,14 @@ func feats_held() -> Array:
|
||||
return _feats.duplicate()
|
||||
|
||||
|
||||
# 主角账只读出口（加算区生产读面承接—— AdventureRunner.hero() 同款组件交出）
|
||||
func hero() -> HeroLedger:
|
||||
return _hero
|
||||
# 主角数值账只读出口（组件交出—— AdventureRunner.stats() 同款；v1.3 hero() 换代）
|
||||
func stats() -> HeroStats:
|
||||
return _stats
|
||||
|
||||
|
||||
# 加算日记只读出口（bonus 生产读面承接——呈现层选路屏/结算行经此读加算区）
|
||||
func journal() -> GainJournal:
|
||||
return _journal
|
||||
|
||||
|
||||
# 凭证出箱注入面（储备金袋 RAP/时沙 首轮 AP；节点级一次性，battle begin 消费后归零；缺省 0=零扰动）
|
||||
@@ -710,10 +724,11 @@ func close_wallet() -> void:
|
||||
# 实装归 ShopSession 件（双模式货架/定价/购买/刷新唯一宿主）；本类保留同签名委托与件注入/
|
||||
# 白盒入口——外部调用面与断点取数面零变化。
|
||||
|
||||
# 件注入（建件与宿主引用换代时调用——钱包/主角账/图行/装配集为共享引用，出账直接落同一引用）
|
||||
# 件注入（建件与宿主引用换代时调用——钱包/主角账三件/图行/装配集为共享引用，出账直接落同一引用）
|
||||
func _bind_shop() -> void:
|
||||
_shop.bind({
|
||||
"hero": _hero,
|
||||
"wallet": _wallet,
|
||||
"journal": _journal,
|
||||
"level_row": level_row,
|
||||
"tree_rules": _tree_rules,
|
||||
"attunement": _attunement,
|
||||
@@ -730,7 +745,7 @@ func _emit_wallet_event(event: String, gp_now: int, extra: Dictionary) -> void:
|
||||
|
||||
# 购血（商店 max_hp 商品——当前生命 +Δ 并封顶新上限，与账本置满/关卡完成回血同式）
|
||||
func _gain_max_hp_flat(flat: int) -> void:
|
||||
hero_hp = mini(hero_hp + flat, effective_max_hp())
|
||||
_stats.hero_hp = mini(_stats.hero_hp + flat, _stats.effective_max_hp())
|
||||
|
||||
|
||||
func shop_products() -> Array:
|
||||
|
||||
Reference in new issue
Block a user