全站留档库

客户端手里的计时器只有增量 15016 一个来源，而增量只在计时器发生变化时下发——重新加入一个已经在跑的事件，服务器不会再补一条增量。
恢复用的数据其实一直都发了：34501 WorldJoinWildEventSCNotify 带 wildEventBt（BehaviorTreeMsg），里面就有 timerList。但 WildEventController.CreateWildEventBT 只把它整个交给 GeneralLogicTreeModel.CreateBehaviorTree 建树，timerList 全程没人读（客户端只在进关卡时消费过 levelBt.timerList）。
Model 里没数据 → GetDisplayTimerName() 返回 undefined → UI 判定「没有要显示的计时器」。

一个 msgId 在 Net 层只能注册一个 handler——NetConnection.Register 发现 NotifyHandles 里已有就直接打 Error 并 return false，不是叠加也不是覆盖，后注册的那个静默失效。所以想在别的模块里消费一条已被占用的协议（这里 34501 归 WildEventController），只能从原注册点调过来，不能自己再 Register 一次。做法是把逻辑留在自己模块里暴露成公开方法，调用点只占一行，模块边界不糊。
另一条更通用：增量协议只在「变化时」下发，凡是「重进 / 重连要恢复显示」的数据，都必须另有一个全量来源。写消费代码时顺手确认全量里那个同名字段有没有人读——这次的 timerList 在协议里躺了很久没人碰。

BombTimerModel.Timers 以 timerName 为 key，存的计时器不知道自己属于哪棵行为树。15016 WorldBehaviorTreeTimerParameterSCNotify 已经带了 type / btTypeId，但客户端只取 btTimerMsg 就丢掉了。
于是退出 / 完成野外事件、行为树被销毁时，客户端手里没有任何线索能判断该清哪条计时器，只能等 GetDisplayTime 把值推到 0、状态自动置 Stopped 后才被 GetDisplayTimerName 过滤掉——这就是「倒计时仍显示」。

行为树派生出来的 UI，清理时机统一挂 GeneralLogicTreeRemove，一个监听点就够——它由 ApplyRemoveBehaviorTree 统一 Emit，天然覆盖退出野外事件（34504）、完成（34505）、事件结束（34507）、服务器删树（15004）、以及离开副本时批量删树五个场景，不用每条协议各接一次，也不需要服务器专门下发一条「关闭 UI」。
前提是这类数据落地时必须带上 treeIncId 归属；只按业务名（这里是 timerName）做 key 的缓存，树一销毁就成了没人认领的孤儿数据。

这次踩到的五条模块知识，除第①条外都跟集合区本身无关，做任何新 UI 都会撞上：
① 关卡级广播驱动的 UI，不能挂在 AOI 实体组件上。最初把提示做成实体组件 EtDungeonGatherComponent（照 EtBoundaryRespawnComponent 的样子写），结果离集合区远的玩家完全看不到提示：服务器 EntityGatherComp::bcUpdateNotify() 走 LevelInst::bc() 遍历 player_map_ 全员下发（不是 bcAoi），而客户端场景物件实体是 AOI 增删的（ServerLevel.UpdatePartial 按 enterEntityList / leaveEntityList），远处玩家的组件压根不存在，广播只写进 Model 没人消费；跑远时 AOI 销毁实体触发 OnEnd() → Hide()，倒计时恰好在最需要它的那个人脸上被关掉；进关卡就在远处时组件不存在，全量兜底也不执行。改成关卡级 Controller 后组件整体删除。判据：这个 UI 该由关卡状态决定可见性，还是由某个实体在不在视野里决定？前者一律挂 Controller；实体组件只做「近处才该看见」的本地表现（特效 / 音效 / 交互提示）。同理适用于任何 LevelInst::bc() 全员下发的协议。
② 客户端运行时的 UI 资源配置读的是 SQLite，不是 json / csv。真正被读的文件是 Client/Content/Aki/ConfigDB/db_ui_resource.db，表里存的是 FlatBuffers blob（SELECT BinData FROM UiResource WHERE Id = ?）。改完 u.UI资源.csv 必须导表，只改 csv 或 UiResource.json 运行时完全看不到。单表导出命令：dotnet ConfigTool.Cmd.dll config -j <proj> -r <configdir> -e -d -a -l -t 1 -f <filter>（-t 1 只导客户端，-f 指定单表过滤文件，几秒钟完事）；导表工具是删掉旧 db 重新建，所以编辑器开着占用文件也不影响。另外查不到的 Id 会被 ConfigCommon.SaveConfig(key, NotFound) 缓存，改完 db 必须重启客户端，热重载 TS 没用。
③ 一个新 UI 界面要登记四处：EUiViewName 枚举 → UiViewStorage.RegisterUiTsInfo → UI资源表（即上面那个 db） → UiShow 表显示配置。少任何一处报的都是 [UiConfig.TryGetViewInfo] 找不到界面配置。
④ LGUI 控件是按预设 LGUIComponentsRegistry.Components 的数组下标取的，不是按名字。代码里 ComponentRegisterInfos 填的那个数字就是 registry 里的位置，UI 那边调整登记顺序，代码必须跟着改；没有「按路径取嵌套控件」的 API。数量或类型对不上时报 [FindInitedComponentRegistryActor]。
⑤ 集合区功能单人测不出来。服务器 total_num = getPlayerNum() 不可覆盖，startGather() 里紧接着就判 in_range_uid_set_.size() ≥ total_num，单人时 1≥1 直接进 FINISHED 并把 force_teleport_time_ms 清 0，客户端连倒计时都收不到。必须 2 人以上联机验证——也正因为如此，上面第①条那个「远处看不到」的问题单人自测根本暴露不出来。

编辑器字段的「可选」有三档，选错直接影响导出的 JSON 体积和默认值归属：
① 只写 Optional → 真可选，不勾就不进 JSON，默认值归服务器；
② 加 IsDefaultCreate → 新建节点时就写死进 JSON，老节点仍然没有；
③ 再加 IsAlwaysShow + DefaultValue → 老节点也直接显示。
渲染判断在 Obj.tsx：Optional && value === undefined && !IsAlwaysShow 就不渲染，所以②对老数据是看不见的，得去节点的「可选▼」里手动勾。IsAlwaysShow 必须配 DefaultValue，否则 OnBaseCheck 抛异常。
另外 CreateDefault 是「从可选菜单勾选时填入的初始值」，不是「不配置时的值」——布尔项勾了却填 false 会让人以为没生效。