Valve 在 2026 年 8 月 24 日的更新里给地图脚本加了 custom_hud_layout 和 cs_player_camera，又在 9 月 9 日的更新把镜头类重做并改了名字，中间还有 7 月 29 日一次 tools 模式脚本加载的修复。接口名都取自官方补丁，参数签名请以你自己地图里的实测为准。

先确认你面对的是哪一版接口

9 月 9 日是破坏性改动：CSPlayerCamera 重做并改名为 CustomPlayerCamera，新增 GetPlayer、GetMode、SetMode、SetFollowConfig，同时把 8 月 24 日刚加的 IsEnabled、SetEnabled、SetIsControllingAngles 标记为废弃。翻旧工程或照抄 8 月底教程，镜头脚本就只跑在废弃接口上。迁移第一步是全文搜 CSPlayerCamera 和那三个旧方法名，改到新接口，再验证切换观战目标后视角跟不跟手。

一、先搭一块自定义 UI

官方把 custom_hud_layout 定位为脚本化地图提供自定义 UI 的入口，支持 Panel、Label、Image、Button 四种面板，支持用 css 做样式，但明确不支持面板的 events 与客户端脚本。合理的分工是布局、文案、贴图放面板，状态判断留在地图脚本。

数据侧 8 月 24 日补了一批接口：CSPlayerPawn 上的 IsBuyMenuOpen、GetC4、GetDefuseTarget、GetCamera，C4 上的 GetPlantStartTime、GetPlantFinishTime，事件侧的 OnBombPlantStart、OnBombDefuseStart 及对应 Abort 版本，以及 Instance.IsDedicatedServer。改事件回调时顺手检查旧参数：OnBombPlant 的 planter、OnBombDefuse 的 defuser 同批被废弃。

二、运行时改外观与状态类

按状态换样式，官方给的是 CustomHudLayout.SetHasClass 与 SetHasClassForPlayer（对全体、对单个玩家），文案变量用 SetDialogVariableString 与 SetDialogVariableStringForPlayer。状态判断留在脚本、外观切换交给类名，就不必为每种状态叠一块新面板。

9 月 9 日补了两个由客户端状态驱动的顶层类：HUD_BUYMENU_VISIBLE 和 HUD_SCOREBOARD_VISIBLE，想让自定义 UI 在买菜单或计分板打开时让位，用它们比自己轮询省事。同条说明还有一句要留意：custom_hud_layout 现在永远画在基础 HUD 之上，遮挡关系调不了，排版时得把准星、血量、计时器的区域让开。

三、按钮点击怎么接住

以下是编辑判断，不是官方原话。同一份 8 月 24 日补丁既写了面板不支持 events，又新增了 Instance.OnCustomHudClicked；把两条放在一起读，可行的做法是在地图脚本层接点击，而不是在面板上绑事件。输入捕获用 SetInputCaptureEnabled，用 IsInputCaptureEnabled 查状态，这两处没设对的常见表现是点了没反应，或者 HUD 开着但人物动不了。

四、镜头只给视角，不给位移

cs_player_camera 的官方描述是在不移动 pawn 的前提下控制玩家视角，并可配置成让玩家从脚本指定的位置环视，适合观察点、固定机位和剧情段落。重做后模式与跟随走 GetMode、SetMode、SetFollowConfig，被观察对象走 GetPlayer，当前镜头仍用 CSPlayerPawn.GetCamera 取。真要搬动实体，同批还有 Entity.Move、SetMoveType 与 CSMoveType 枚举，排时间线用 Instance.Delay。

五、观战一致性是后加的那条

9 月 9 日给 custom_hud_layout 加了 observable 属性，控制观战者看到的是否与被观察玩家一致，官方写明默认 false。只给本人看的操作面板用默认值正好，要给观战和直播看的公开状态板必须显式改。这条补丁同时修掉了切换观战目标时 HUD 状态残留的问题，若在 9 月 9 日之前的构建上排查过"换人后面板还是上一个玩家的"，那是同一个坑。

六、tools 模式下的调试顺序

先看控制台。8 月 24 日起脚本初次运行的错误与未捕获的 promise rejection 会记录到控制台，CompileModule 的报错还补上了列号。
改完不生效就手动重编译。7 月 29 日修的正是 tools 模式下要手动重编译才加载的问题。
面板重载后确认状态没丢，官方说明 custom_hud_layout 在 tools 模式重载期间保持状态。
单独走一遍观战路径：切目标、看 observable 的表现、确认单人方法的效果没串到别人屏幕上。

补丁只给了实体名和方法名，没给参数签名、面板布局语法和 css 可用选择器范围，这三块只能在自己的地图里实测。