地图与场景
检查人物是否在指定地图
检查当前人物是否位于指定地图。
命令用途
IsOnMap 用于检查当前人物是否位于指定地图。
它常用于地图入口限制、剧情阶段判断和地图内外分流处理。
命令名
IsOnMap
调用格式
IsOnMap <地图编号>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
地图编号 | 是 | 要检查的地图编号。 |
返回或影响
- 这是检查型命令，只在条件判断流程中使用。
- 当当前人物位于指定地图时，
#IF条件成立。 - 当人物不在目标地图时，条件不成立。
示例
基础用法
#IF
IsOnMap 0105
#ACT
MoveToCell 7 19 传送到目标区域
这段写法会先检查当前人物是否位于地图 0105，成立后再执行后续移动逻辑。
常见变体
[@LeaveMap]
#IF
IsOnMap 3
#ACT
SendMsg 6 "你当前仍在地图3内。"
这段写法适合在地图离开或地图事件流程里，判断角色是否仍停留在指定地图。
注意事项
- 这条命令只检查地图，不检查坐标范围。
- 如果需要同时检查地图和坐标范围，应改用 检查是否在地图坐标范围内。