传奇广寒仙境副本NPC传送脚本与地图怪物掉落计时通关写法

[@main]
#ACT
MESSAGE 广寒仙子立于云雾之间，广寒仙境为限时副本，击杀月宫玉兔与寒月妖王可获取月宫珍宝
MESSAGE 1.进入广寒仙境副本 2.查看副本规则 3.关闭对话
BREAK
[@进入广寒仙境副本]
#IF
CHECKLEVEL >=55
CHECKITEM 广寒玉符 1
#ACT
TAKE 广寒玉符 1
MAPMOVE 广寒仙境 80 60
CALCVAR HUMAN GuangHanTime = 1
SAVEVAR HUMAN GuangHanTime ..\QuestDiary\guanghan\playerdata.txt
TIMERADD 广寒计时 1800
MESSAGE 传送开启，你已进入广寒仙境，副本限时30分钟，时间到自动传出地图
SENDMSG 5 踏入广寒仙境，尽快击杀月宫魔物获取珍宝
BREAK
#ELSEACT
MESSAGE 进入条件不足，需要角色等级55级，背包携带广寒玉符一枚
BREAK
[@查看副本规则]
#ACT
MESSAGE 广寒仙境为单人限时副本，消耗广寒玉符进入，副本持续30分钟
MESSAGE 副本内怪物包含月宫玉兔、寒月妖王，妖王掉落高阶装备与月宫材料
MESSAGE 副本时间耗尽，角色将被强制传送离开，提前离开可使用回城道具
MESSAGE 副本内不可使用随机传送，死亡直接传出副本，本次副本提前结束
BREAK
[@关闭对话]
#ACT
MESSAGE 集齐广寒玉符，即可前往月宫秘境探寻宝物
BREAK

QFunction-0.txt 副本计时、传送、死亡触发脚本
[@OnTimer]
#IF
ISMAP 广寒仙境
TIMEREXIST 广寒计时
#ACT
TIMERDEL 广寒计时
MAPMOVE 3 330 330
CALCVAR HUMAN GuangHanTime = 0
SAVEVAR HUMAN GuangHanTime ..\QuestDiary\guanghan\playerdata.txt
MESSAGE 广寒仙境时限已到，寒气消散，被传送回安全区域
SENDMSG 5 广寒仙境副本结束
BREAK
[@OnPlayerDeath]
#IF
ISMAP 广寒仙境
#ACT
TIMERDEL 广寒计时
MAPMOVE 3 330 330
CALCVAR HUMAN GuangHanTime = 0
SAVEVAR HUMAN GuangHanTime ..\QuestDiary\guanghan\playerdata.txt
MESSAGE 你在广寒仙境陨落，副本提前终止，传送返回盟重安全区
BREAK
[@OnPlayerLogout]
#IF
ISMAP 广寒仙境
#ACT
TIMERDEL 广寒计时
CALCVAR HUMAN GuangHanTime = 0
SAVEVAR HUMAN GuangHanTime ..\QuestDiary\guanghan\playerdata.txt
BREAK

机器人脚本，副本怪物定时刷新
[@Start]
#ACT
TIMERADD GuangHanMonster 60
BREAK
[@OnTimer GuangHanMonster]
#IF
#ACT
CHECKMAPHUMAN 广寒仙境
#IF
#ACT
MONGEN 月宫玉兔 10 0
MONGEN 寒月妖王 1 0
BREAK
BREAK

整套脚本适配Hero引擎，分为NPC传送交互模块、QFunction全局触发器、机器人定时刷怪模块。脚本存放路径为QuestDiary目录新建guanghan文件夹，playerdata.txt用于记录副本状态，文件夹未创建会造成变量无法保存，副本计时异常。NPC无管理员权限限制，普通玩家对话即可打开面板，设置等级门槛与道具消耗控制副本准入。

进入副本时扣除广寒玉符，添加玩家标记GuangHanTime，同时开启1800秒定时器作为副本倒计时。[@OnTimer]监控副本时间，倒计时结束删除定时器，将玩家传送回盟重安全区，清空副本状态标记。角色在副本内死亡、下线都会触发副本终止逻辑，清除定时器重置变量，避免定时器残留持续占用资源。

机器人脚本负责怪物定时刷新，每60秒检测广寒仙境地图内是否存在玩家，有玩家在场才批量生成月宫玉兔与寒月妖王，地图无人时不会刷怪，防止怪物堆积占用服务器内存。怪物名称需要和怪物数据库内名称完全一致，MONGEN第二个参数为刷新间隔，填0代表一次性立刻刷新。

测试阶段，准备满足等级条件的角色携带广寒玉符进入副本，验证倒计时、死亡退出、下线重置、怪物刷新逻辑。可修改副本时长，调整TIMERADD后的秒数，修改进入所需等级、消耗道具，也可修改传送目标地图坐标。可以调整怪物数量，增减玉兔数量或者增加更多BOSS种类。

可扩展多种副本玩法，增加多人组队进入判断，组队队长消耗道具全队传送。增加副本内任务，击杀指定数量玉兔领取额外奖励。增加首杀奖励，首次击杀寒月妖王发放一次性专属道具。增加副本每日进入次数限制，使用日期变量控制每日最多进入次数。增加副本内禁止使用随机、飞行类道具的拦截脚本，防止玩家利用地图漏洞。

需要核对引擎指令兼容情况，部分旧版Hero引擎TIMERADD玩家定时器存在兼容问题，倒计时不生效时核对M2版本。广寒玉符道具、月宫玉兔、寒月妖王怪物、广寒仙境地图文件都需要提前在服务端配置，缺失地图文件会导致传送失败。

副本变量GuangHanTime用来标记玩家是否处于副本状态，每个角色独立存储，多名玩家同时进入副本互不干扰。副本倒计时为角色独立定时器，每位进入副本的玩家单独计时，互不影响。如果需要增加副本通关奖励，可在寒月妖王死亡触发分支添加奖励发放，击杀妖王直接发放月宫材料。

地图参数需要在地图文件内设置，开启禁止随机、禁止行会召唤等属性，搭配脚本实现副本限制。副本结束后不会自动清理地图残留怪物，可在玩家全部离开地图时增加怪物清除脚本，清空地图所有怪物，保证下一次进入副本环境干净。可增加副本内专属增益，进入副本自动附加临时攻击buff，离开副本自动清除属性加成。