传奇引擎地图切换触发脚本与地图ID名称调用教程
本文详解传奇服务端地图切换触发脚本用法，讲解QFunction-0.txt进入地图触发代码配置，分享传奇地图编号与名称双向调取变量指令，附带完整可直接套用的脚本代码及实战注意事项，适合传奇版本制作者、脚本开发者学习参考。…
一、地图切换触发功能概述
传奇服务端脚本开发中，地图切换触发为高频基础功能。玩家进出、切换地图时可自动执行脚本指令，常用于地图准入校验、界面提示、BUFF添加、区域规则限制等场景，是传奇版本定制、玩法优化的核心脚本功能。
二、地图切换核心触发脚本配置
该功能依托QFunction-0.txt全局触发文件运行，内置[@EnterMap]专属进入地图触发入口，可捕获所有玩家地图切换行为，自动执行预设脚本逻辑。
2.1 基础地图切换触发代码
;QFunction-0.txt触发段
[@EnterMap]
#IF
#ACT
SENDMSG 5 你已更换地图....切换前地图为：<$oldmap>
2.2 脚本代码说明
QFunction-0.txt为传奇引擎全局触发文件，无需额外配置挂载，放入服务端默认脚本目录即可生效。[@EnterMap]是固定触发入口，玩家跳转地图后立即执行；无条件#IF默认生效，直接运行#ACT内的指令代码。
SENDMSG 5为客户端居中提示指令，用于向玩家推送弹窗信息；内置变量<$oldmap>可读取玩家切换前的地图名称，实现地图切换信息展示。
三、传奇地图编号与名称互调变量用法
地图脚本开发中，常需实现地图ID与名称互查。传奇引擎内置两组专用变量，可快速完成双向调取，适配脚本判定、界面展示、权限过滤等开发场景。
3.1 通过地图编号获取地图名称
调用格式：<$GetMapTitle(X)>
参数X为地图数字编号，调用后自动返回对应地图官方名称，适用于已知地图ID、需要展示中文地图名的场景。
3.2 通过地图名称获取地图编号
调用格式：<$GetMapID(X)>
参数X为完整地图名称，引擎可检索对应地图编号。存在重名地图时，仅读取首个匹配ID，建议统一地图名称避免脚本异常。
四、实战使用注意事项
地图触发脚本必须写入QFunction-0.txt，自定义文件无法被引擎识别；调取地图信息时，名称需严格匹配MapInfo.txt原生格式；规避重名地图，防止GetMapID读取ID错误引发脚本故障。
灵活运用地图切换触发与地图调取变量，可快速制作地图禁入、区域福利、跨图提示、专属怪物刷新等功能，提升传奇版本可玩性与差异化。
