shenleiandClaude Opus 5
e0c1853909
实机故障：进入游戏后整屏灰紫，主角还是蓝色胶囊占位体，2D UI 与小地图正常。 根因（已实证，非推测）。`EntityStore::mut_despawn()` 在 despawn 的 vid 等于 主角 vid 时把 `m_main_vid` 清零。40250 服务器在 spawn-in 头几秒会对玩家自己的 vid 反复下发 GC_CHARACTER_DEL + GC_CHARACTER_ADD（视野重算，实测约 10 次）。 第一次 DEL 就把玩家永久去主角化：`get_main_vid()` 返回 0 → `_sync_main_character()` 直接 return → 建模代码从未跑过（main_attempts=0）→ 占位胶囊留在 y=0 → 相机跟着它钻到 C1 地形底下 → 满屏灰紫。地图其实一直是好的 （chunks_built 20/20、objects_placed 565）。 参考端怎么做（40250 ClientVS22）。主角身份属于 `CNetworkActorManager::m_dwMainVID`， 只由 `SetMainActorVID()`（GC_MAIN_CHARACTER）写，只在管理器析构时清； `RemoveActor()` 删 actor 行和角色实例，但绝不碰它；重新加入时 `__AppendCharacterManagerActor()` 用 `kCreateData.m_isMain = __IsMainActorVID(dwVID)` 重新推导，并再跑一次 `SetMainCharacterIndex(dwVID)`。 修法（entity_store.cpp）： - `mut_despawn()` 只删行、只发 Despawn，不动 m_main_vid；m2dev 分支的 GC_CHARACTER_DEL 同规则。 - `mut_spawn_full()` 在 `e.vid == m_main_vid` 时把 `is_main` 置回 true， 并重新广播 MainSet，对齐参考端的重新推导。 顺带落地的渲染修复（同一次实机排查中定位）： - libgr2 `sample_pose()` 增加 `root_offset` 形参；`Metin2AnimPlayer::apply_pose()` 显式传单位阵而不是模型的 InitialPlacement。Metin2 动画 gr2 的根骨轨道自带骨盆 高度，再乘一次 IP 会把整个人抬高一个骨盆高（武 99.4cm / 刺 92.6 / 巫 103.7 / 萨 95.5，正好各自的 IP.z）——即此前的「人物悬空」。`bind_pose()` 语义不变。 - `Metin2Model::_load_hair()` 改用与身体/武器同一条 `make_material()` （specular_disabled）而不是 roughness=1.0 的 StandardMaterial3D，头发不再被 PBR 高光洗成奶白色块。 取证与回归工具： - `project/net_trace.gd`（新）：主角 vid 生命周期取证。挂在 AppFlow 之后逐帧读 `get_main_vid()`，归零时打印 `NETTRACE: MAIN_LOST was=.. now=0 reason=..` 加最近 24 条环形事件；`reason` 区分 despawn 与 silent（reset_for_map_change 清空 m_changes，是静默清零）。`MT_NETTRACE=1` 打开逐事件日志。 - `game_scene.gd`：诊断 tick 支持重复采样（分辨主角装配是「没跑」还是「没跑完」）， 新增 main_sync_ready / main_loading / main_view_key / main_map_vid / main_retry_in_ms 字段；`MT_DIAG_SHOT=<png>` 让游戏自己存一帧实机画面 （screencapture 拍到的是终端窗口，没用）。 - `project/model_render_test.gd` + `test/rendering/model_baseline.json`（新）： 八个种族的模型渲染基线（--bless 重新落盘）。 - `project/char_bench_test.gd`（新）：无网络无地图的单角色实验台，五变体 × 六机位出证据图，只产图不做阈值判定。 - `project/package_render_test.gd`（新）：导出包内的渲染自检入口 （导出模板不接受 --script，只能走 MT_TEST_MODE）。 - `/project/build/` 加入 .gitignore（渲染用例的落图输出）。 实机复验（真实服务器，非模拟）： - 修前 `LIVE_SMOKE FAIL: 主角色 VID 有效`； `NETTRACE: MAIN_LOST was=25910 now=0 reason=despawn t=+7737ms`， 环里紧跟 `spawn vid=25910 is_main=false`。 - 修后 `LIVE_SMOKE RESULT: PASS`，main_vid=25933、entities=19； 40s 实机跑 16 次诊断采样全部 model_built=True / main_attempts=1 / main_sync_ready=True，player_pos 落在 C1 地形上而非 y=0； MT_DIAG_SHOT 存下的帧里地形、建筑、NPC、树木、真实角色模型、HUD、小地图俱全。 回归：gamescene_test / equip_model_test / gamescene_visual_test（feet_gap 0.001373）/ model_render_test（8 races）/ char_select_visual_test / 包内 MT_TEST_MODE=render 全绿；ctest 22/23，唯一失败 net.classic_session 已用 「还原本次改动 → 重跑 → diff 失败集合」确认与本次修改无关（失败集合完全相同）。 注：画面整体偏暗属于光照/色调差距，受 PARITY-GAP.md §0 门禁约束（对照帧未落盘前 不做相机/光照/色调/材质调参），本次不碰。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SJugvEJwz3FK4hw9ti3SRb
47 lines
2.0 KiB
GDScript
47 lines
2.0 KiB
GDScript
# client_main —— 打包客户端的入口场景根（main_scene = res://client_main.tscn）。
|
||
#
|
||
# 只做一件事：起 AppFlow（登录 → 选人 → 进游戏 串场控制器）。
|
||
# 资源目录由 AssetRoot 决定：默认 res://../assets（开发树），打包后设环境变量
|
||
# MT_ASSETS 指向真实资源目录即可（见 project/asset_root.gd）。
|
||
extends Node
|
||
|
||
const AppFlow = preload("res://app_flow.gd")
|
||
const LiveSmokeTest = preload("res://live_smoke_test.gd")
|
||
const PackageRenderTest = preload("res://package_render_test.gd")
|
||
const NetTrace = preload("res://net_trace.gd")
|
||
|
||
func _ready() -> void:
|
||
# MT_TEST_MODE=render：包内离线渲染自检，不起 AppFlow、不连服务器。
|
||
# 导出模板不接受 --script，这是导出包里唯一能跑离线渲染回归的入口。
|
||
if OS.get_environment("MT_TEST_MODE") == "render":
|
||
AssetPack.ensure()
|
||
var t := PackageRenderTest.new()
|
||
t.name = "PackageRenderTest"
|
||
add_child(t)
|
||
return
|
||
# 打包 app 从 Finder/open 启动时没有 shell 环境；40250 服务器使用 classic
|
||
# DH2/CTR 协议，因此默认固定到 classic，同时保留 MT_PROTOCOL 覆盖能力。
|
||
if OS.get_environment("MT_PROTOCOL").is_empty():
|
||
OS.set_environment("MT_PROTOCOL", "classic")
|
||
# 移动端：APK/IPA 里没有资源 —— 挂载外部的 assets.zip（adb push / ios-deploy 上传）。
|
||
AssetPack.ensure()
|
||
var root := AssetRoot.path()
|
||
if not AssetRoot.available():
|
||
push_warning("[client] 资源目录不存在：%s —— MT_ASSETS 环境变量 / assets.zip（adb push 到 files/）" % root)
|
||
var af := AppFlow.new()
|
||
af.name = "AppFlow"
|
||
add_child(af)
|
||
af.start(root)
|
||
# 主角 vid 生命周期取证（见 net_trace.gd）：排在 AppFlow 之后，保证每帧
|
||
# 在 client 派发完信号之后再读 main_vid。
|
||
if af.client != null:
|
||
var trace := NetTrace.new()
|
||
trace.name = "NetTrace"
|
||
add_child(trace)
|
||
trace.setup(af.client)
|
||
if OS.get_environment("MT_TEST_MODE") == "smoke":
|
||
var smoke := LiveSmokeTest.new()
|
||
smoke.name = "LiveSmokeTest"
|
||
add_child(smoke)
|
||
smoke.setup(af, af.client)
|