地图与场景
检查镜像地图是否存在
检查指定镜像地图是否已经存在，适用于副本入口判断、镜像回收前校验和重复创建防护。
命令用途
CopyMapExists 用于检查指定镜像地图是否已经存在。
它常用于副本入口判断、镜像地图复用、删除前确认，以及避免重复创建同名镜像地图。
命令名
CopyMapExists
调用格式
CopyMapExists <镜像地图名>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
镜像地图名 | 是 | 要检查的镜像地图名称。这里检查的是镜像地图实例名，不是源地图名称。 |
返回或影响
- 这是检查型命令，只能在条件判断流程中使用。
- 当目标镜像地图已经存在时，
#IF条件成立。 - 当目标镜像地图不存在时，条件不成立。
- 这条命令不会自动创建镜像地图，也不会自动把人物传进去。
示例
基础用法
#IF
CopyMapExists <$STR(S副本地图)>
#ACT
MapMove <$STR(S副本地图)> 14 17
#ELSEACT
MessageBox 当前副本尚未创建。
这段写法会先判断目标镜像地图是否存在，只有存在时才允许传入。
常见变体
#IF
!CopyMapExists <$STR(S副本地图)>
#ACT
MessageBox 当前副本已经失效，请重新进入。
BREAK
这段写法适合在副本回城、回传或回收流程中，先判断镜像地图是否还存在。
注意事项
- 这条命令只做存在性判断，不会替代创建镜像地图或进入镜像地图的命令。
- 参数写错时，脚本会把它当成另一张地图名处理，常见结果是条件始终不成立。
- 如果你的脚本是“存在则进入，不存在则创建”，应先判断，再分别接创建和传送流程。