地图与场景
检查范围玩家数量
检查指定地图坐标范围内的玩家数量是否满足比较条件。
命令用途
CheckRangePlayerCount 用于检查指定地图坐标范围内的玩家数量，并按比较结果决定当前条件是否成立。
它常用于活动限流、区域拥挤度控制、战场入口门槛和局部清场检测。
命令名
CheckRangePlayerCount
调用格式
CheckRangePlayerCount <地图编号> <X坐标> <Y坐标> <范围> <控制符> <数量> <包含死亡>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
地图编号 | 是 | 要检查的地图编号。 |
X坐标 | 是 | 检查中心点的 X 坐标。 |
Y坐标 | 是 | 检查中心点的 Y 坐标。 |
范围 | 是 | 以中心点向外统计玩家数量的范围。 |
控制符 | 是 | 支持 >、<、=，分别表示大于、小于、等于。 |
数量 | 是 | 用来比较的玩家数量阈值。 |
包含死亡 | 是 | 0 表示不统计死亡角色，1 表示统计死亡角色。 |
返回或影响
- 这是检查型命令，只在条件分支中返回成立或不成立。
- 当指定地图坐标范围内的玩家数量满足比较条件时，
#IF条件成立。 - 是否把死亡角色计入统计，取决于最后一个参数。
示例
基础用法
#IF
CheckRangePlayerCount 3 330 330 10 > 10 0
#SAY
目标区域内存活玩家数量大于 10。
#ELSESAY
目标区域内存活玩家数量不超过 10。
这段写法会检查地图 3 的 330,330 周围 10 格内，存活玩家数量是否大于 10。
常见变体
#IF
CheckRangePlayerCount 3 330 330 10 = 0 1
#ACT
SendMsg 6 "目标区域已经没有任何角色，可以重置场景。"
这段写法会检查指定区域内是否已经没有任何角色，包括死亡角色。
注意事项
- 最后一个参数会影响是否把死亡角色计入统计，活动清场判断时应明确写对。
- 这条命令统计的是玩家数量，不包含怪物或 NPC。
- 如果你要检查人物自己是否在某个区域，应改用 检查是否在地图坐标范围内。