Valve 在 2026 年 8 月 3 日的更新里一次性把手雷与炸弹的脚本接口铺开，8 月 24 日的更新又补上安放与拆除的过程事件。这两批接口是自定义地图做雷区玩法、训练图和特殊模式的地基。方法名全部取自官方补丁原文，参数签名和枚举取值公告里没有，需要你在自己的地图里实测。

一、先分清两类对象

按 8 月 3 日的清单，飞行中的手雷走 CSGrenadeProjectileBase：GetGrenadeType 判类型、GetThrower 取投掷者、Detonate 主动引爆，类型枚举是 CSGrenadeType。已经安放的炸弹走 CSPlantedC4：IsBombsiteA、IsBombsiteB 判点位，GetPlanter、GetDefuser 取人，IsActive、IsExploded、IsDefused 判状态，GetPlantTime、GetExplodeTime、GetDefuseStartTime、GetDefuseFinishTime 给时间线。

二、轨迹与落点怎么读

同一批给 Instance.OnGrenadeBounce 事件的参数补上了 hitEntity 与 normal，也就是弹到了哪个实体、命中面的法线，这是做落点提示、区域判定和弹射玩法的关键两项。注意官方同时把 bounces 标记为废弃，靠数弹跳次数的旧写法要改。另外新增 Instance.SpawnGrenadeProjectile 自己生成手雷投射物，Instance.TracePlayer 补上玩家射线检测，Instance.OnWeaponPickup 与 OnWeaponDrop 的 dropper 参数用于武器拾取和掉落链路。

三、安放与拆除的过程事件

8 月 24 日补的是过程而不只是结果：Instance.OnBombPlantStart、OnBombPlantAbort、OnBombDefuseStart、OnBombDefuseAbort，加上 8 月 3 日已有的 OnBombExplode，一次完整的下包到引爆链路就都能监听了。对象侧新增 CSPlayerPawn.GetC4 与 GetDefuseTarget，C4 上有 GetPlantStartTime、GetPlantFinishTime 和 AbortPlant，排时间线用 Instance.Delay。同一批把 OnBombPlant 的 planter、OnBombDefuse 的 defuser 标记为废弃。

这里有个必须自己验证的点，以下是编辑判断而不是官方原话：8 月 3 日列的是 CSPlantedC4.GetPlantTime、GetDefuseStartTime，8 月 24 日列的是 C4.GetPlantStartTime、AbortPlant，两份公告的类名与方法名并不完全一致。合理做法是先 CSPlayerPawn.GetC4 拿对象，再在你当前构建里确认可用的类名与方法，不要假设 CSPlantedC4 与 C4 是稳定别名，也不要直接照抄另一份公告的写法。

四、拆弹器

CSPlayerPawn.HasDefuser 读、SetHasDefuser 写，8 月 3 日加入。做拆弹器掉落或抢占类玩法时，用它比靠物品栏推断更直接。

五、调试顺序

先看控制台。8 月 24 日起脚本初次运行的错误与未捕获的 promise rejection 会记录到控制台，CompileModule 的报错还补上了列号。
tools 模式下脚本没加载，先手动重编译一次，7 月 29 日的补丁修的正是这个问题。
重载后 Instance.RegisterCheatCommand 注册的命令失效，是 8 月 3 日已经修掉的旧 bug，停在更早构建上的话先确认自己是否还在踩。
分支逻辑用 Instance.IsDedicatedServer 区分专用服与本地或工具环境，别只在单机里验证通过就上线。

官方公告只到方法名为止，参数、返回值与 CSGrenadeType 的成员都要在自己的地图里实测确认。