地图与场景
检查是否在地图坐标范围内
检查当前人物是否位于指定地图坐标范围内。
命令用途
CheckInMapRange 用于检查当前人物是否位于指定地图坐标范围内。
它常用于活动区域门槛、站位检测、进入触发区判断和场景阶段分流。
命令名
CheckInMapRange
调用格式
CheckInMapRange <地图号> <X坐标> <Y坐标> <范围>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
地图号 | 是 | 要检查的目标地图编号。 |
X坐标 | 是 | 检查中心点的 X 坐标。 |
Y坐标 | 是 | 检查中心点的 Y 坐标。 |
范围 | 是 | 以中心点向外判断的范围。 |
返回或影响
- 这是检查型命令，只在条件分支中返回成立或不成立。
- 当当前人物位于指定地图且落在目标坐标范围内时，
#IF条件成立。 - 当地图不一致或坐标超出范围时，条件不成立。
示例
基础用法
#IF
CheckInMapRange 3 330 330 10
#ACT
SendMsg 6 "你已经进入地图3的目标区域。"
这段写法会检查当前人物是否位于地图 3 的 330,330 周围 10 格范围内。
常见变体
#IF
CheckInMapRange 3 100 100 3
#SAY
你已进入活动核心区。
#ELSESAY
请继续靠近活动中心点。
这段写法适合用在活动入口附近的精确区域检测。
注意事项
- 这条命令同时检查地图和坐标范围，不是单纯的地图判断。
范围越小，检测越严格；如果只是判断是否在某张地图，应改用 检查人物是否在指定地图。