地图与场景
检查地图人数
检查指定地图中的人物数量是否满足条件，适用于地图限流、活动场景开放判断和人数门槛控制。
命令用途
CheckMapHumanCount 用于检查某张地图内的人物数量，并按比较结果决定当前脚本分支是否成立。
这类命令常用于活动地图限流、地图开放条件、人数阈值控制，以及进入场景前的人数判定。
命令名
CheckMapHumanCount
调用格式
CheckMapHumanCount <地图号> <比较符> <数量>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
地图号 | 是 | 需要检查的人数所在地图编号，例如 3。这里使用的是地图编号，不是地图名称。 |
比较符 | 是 | 支持 <、>、=，分别表示小于、大于、等于。 |
数量 | 是 | 用来比较的人数阈值。 |
返回或影响
- 这是检查型命令，只能在条件判断流程中使用。
- 当地图当前人数满足比较条件时，
#IF条件成立，进入后续#ACT、#SAY或其它分支。 - 当条件不成立时，脚本会走
#ELSEACT、#ELSESAY，或者直接继续后续不依赖该条件的流程。 - 该命令本身不修改地图状态，也不会传送、踢人或限制进入；这些行为需要由后续脚本显式处理。
示例
基础用法
[@检查地图人数]
#IF
CheckMapHumanCount 3 < 100
#SAY
地图 3 当前人数小于 100，可以继续进入。
#ELSESAY
地图 3 当前人数已达到 100 或更多，请稍后再试。
这段写法用于判断地图 3 当前人数是否小于 100。条件成立时提示可以继续进入，不成立时提示人数已满。
常见变体
[@检查地图人数]
#IF
CheckMapHumanCount 3 = 0
#ACT
SendMsg 6 "地图3当前无人，可以执行下一阶段脚本。"
BREAK
这段写法用于检查指定地图是否已经没人，适合用在活动切阶段、刷怪前检测或场景重置前判断。
注意事项
- 该命令比较的是指定地图中的人物数量，不是当前地图人数，也不是怪物数量。
- 如果要检查怪物数量，应改用对应的地图怪物检查命令，不要把人物和怪物命令混用。
地图号必须写对；如果业务资料使用的是地图名称，需要先确认实际脚本里对应的编号。- 这是纯检查命令。即使条件成立，也不会自动执行限流、传送或公告，后续动作必须在脚本里单独写明。