《反恐精英2》（CS2）推出新版本更新，本次更新公告的内容全部集中在地图脚本（Map Scripting）：新增 custom_hud_layout 自定义 HUD 实体与 cs_player_camera 玩家镜头实体，同时补充了大量脚本接口，涵盖炸弹安放/拆除的过程事件、实体移动类型控制、C4 状态读取等，并改进了脚本报错的日志输出。以下按板块整理这次 CS2 地图脚本更新的具体内容。
CS2本次更新时间与更新范围
- 更新公告发布时间：2026年8月25日 07:39
- 本次公告列出的条目全部属于地图脚本范畴，面向使用脚本制作地图的作者
custom_hud_layout实体：脚本地图的自定义UI入口
custom_hud_layout 是脚本地图提供自定义 UI 的入口，支持范围如下：
- 支持 Panel、Label、Image、Button 四种面板类型
- 支持使用 CSS 设置样式
- 不支持事件与客户端脚本
- 在 tools 模式重载期间会保持状态
cs_player_camera实体：不移动角色的视角控制
cs_player_camera 用于控制玩家视角，但不移动玩家的 pawn（角色实体）。
CS2地图脚本新增接口一览
Instance 新增接口
- Instance.Delay
- Instance.OnBombPlantStart
- Instance.OnBombPlantAbort
- Instance.OnBombDefuseStart
- Instance.OnBombDefuseAbort
- Instance.OnCustomHudClicked
- Instance.IsDedicatedServer
Entity 新增接口
- Entity.Move
- Entity.GetMoveType
- Entity.SetMoveType
CSPlayerPawn 新增接口
- CSPlayerPawn.GetC4
- CSPlayerPawn.GetDefuseTarget
- CSPlayerPawn.IsBuyMenuOpen
- CSPlayerPawn.GetCamera
C4 新增接口
- C4.GetPlantStartTime
- C4.GetPlantFinishTime
- C4.AbortPlant
CustomHudLayout 新增接口
- CustomHudLayout.SetHasClass
- CustomHudLayout.SetHasClassForPlayer
- CustomHudLayout.SetDialogVariableString
- CustomHudLayout.SetDialogVariableStringForPlayer
- CustomHudLayout.SetInputCaptureEnabled
- CustomHudLayout.IsInputCaptureEnabled
CSPlayerCamera 新增接口
- CSPlayerCamera.IsEnabled
- CSPlayerCamera.SetEnabled
- CSPlayerCamera.SetIsControllingAngles
新增枚举
脚本报错日志与类型修正
- 修正了部分事件中参数可能为 undefined 的类型定义
- 脚本初次运行时遇到的错误现在会记录到控制台
- 未处理的 promise rejection（未捕获的 Promise 异常）现在会记录到控制台
- 脚本加载的 CompileModule 阶段捕获到的错误，现在会附带列号
弃用接口：OnBombPlant的planter与OnBombDefuse的defuser
- Instance.OnBombPlant 事件中的 planter 参数已弃用
- Instance.OnBombDefuse 事件中的 defuser 参数已弃用
正在使用这两个参数的地图脚本需要留意后续兼容性。
哪些人需要关注这次CS2更新
本次 CS2 更新公告的全部条目都围绕地图脚本展开，最直接相关的是制作脚本地图的地图作者：custom_hud_layout 提供了脚本地图搭建自定义界面的入口，cs_player_camera 提供了不移动角色即可控制视角的手段，配合新增的炸弹安放与拆除过程事件（OnBombPlantStart、OnBombPlantAbort、OnBombDefuseStart、OnBombDefuseAbort）以及 C4 相关接口，可以在下包与拆包的过程中接入自定义逻辑。如果你正在维护脚本地图，建议优先检查已弃用的 planter 与 defuser 参数。
