地图禁止携带宠物功能通过传奇脚本中的地图触发机制实现。核心原理是利用地图事件检测玩家进入特定区域，随后执行脚本检查宠物状态并处理。该功能类似进入皇宫自动清除宠物的效果，确保特定地图规则被执行。
地图触发原理与配置
传奇引擎通过MapEvent.txt文件定义地图事件，当玩家进入指定地图时触发对应脚本。实现禁止宠物功能需配置地图触发事件，将地图编号与执行脚本关联。
在MapEvent.txt中添加事件行，格式为“地图编号 触发类型 触发条件 执行脚本”。例如设置地图3（皇宫）在玩家进入时触发，添加行“3 0 0 @进入皇宫处理”。其中3为地图编号，0代表进入触发，第二个0为触发参数，@进入皇宫处理为执行的脚本标签。
触发类型包括进入触发、离开触发、定时触发等。禁止宠物通常使用进入触发，确保玩家踏入地图瞬间执行检查。部分引擎支持更精细触发条件，如等级范围、职业限制，可结合使用增强控制。
地图编号需准确对应游戏地图文件。查看MapInfo.txt文件确认皇宫地图编号，常见编号如3（皇宫）、0150（沙巴克皇宫）等。错误地图编号导致触发失效。
多地图批量禁止宠物可使用通配符或重复配置。某些引擎支持地图范围触发，如“3-10 0 0 @处理宠物”表示地图3到10均触发。也可逐行配置每个需要禁止宠物的地图。
宠物检测与处理脚本
触发脚本负责检测玩家携带宠物状态并执行清除操作。脚本需包含宠物检测、清除命令和提示信息，确保功能完整可靠。
基础检测清除脚本示例：
[@进入皇宫处理]
#IF
CHECKPET
#ACT
KILLPET
SENDMSG 5 提示：本地图禁止携带宠物，您的宠物已被清除。
#ELSEACT
SENDMSG 5 提示：您已进入皇宫区域，请遵守地图规则。
CHECKPET命令检测玩家是否召唤宠物，返回真值表示有宠物存在。KILLPET命令立即清除玩家召唤的宠物，无论宠物类型和等级。SENDMSG命令发送提示信息给玩家，5代表私人聊天窗口显示。
增强脚本可添加多重检测和日志记录：
[@进入皇宫处理]
#IF
CHECKPET
#ACT
KILLPET
SENDMSG 5 提示：本地图禁止携带宠物，您的宠物已被清除。
SENDMSG 1 系统：玩家<$USERNAME>在皇宫因违规携带宠物被清除。
CALCVAR GLOBAL 皇宫宠物清除次数 + 1
SAVEVAR GLOBAL 皇宫宠物清除次数 ..\QuestDiary\数据文件\违规记录.txt
#ELSEACT
SENDMSG 5 提示：您已进入皇宫区域，请遵守地图规则。
此脚本增加全服公告、全局变量记录清除次数。SENDMSG 1向全服发送系统消息，CALCVAR和SAVEVAR记录违规次数到文件，便于管理查询。
宠物类型识别与差异化处理
不同宠物类型需差异化处理，某些地图可能允许特定宠物进入。通过检测宠物名称或类型实现选择性清除。
检测特定宠物名称脚本：
[@进入皇宫处理]
#IF
CHECKPET
#ACT
CHECKPETNAME 神兽
#ACT
KILLPET
SENDMSG 5 提示：本地图禁止携带神兽，您的宠物已被清除。
BREAK
#IF
CHECKPETNAME 骷髅
#ACT
SENDMSG 5 提示：您携带的骷髅允许进入本地图。
BREAK
#ELSEACT
KILLPET
SENDMSG 5 提示：本地图禁止携带宠物，您的宠物已被清除。
CHECKPETNAME命令检测宠物具体名称，针对不同宠物执行不同操作。此例中神兽被清除，骷髅允许进入，其他宠物一律清除。BREAK命令防止脚本继续执行。
基于宠物等级的处理脚本：
[@进入皇宫处理]
#IF
CHECKPET
#ACT
CHECKPETLEVEL > 3
#ACT
KILLPET
SENDMSG 5 提示：本地图禁止携带3级以上宠物，您的宠物已被清除。
#ELSEACT
SENDMSG 5 提示：您的宠物符合进入要求。
CHECKPETLEVEL检测宠物等级，大于3级时清除。实现按等级限制宠物进入，低等级宠物可保留。
地图触发脚本集成位置
触发脚本需放置在引擎可识别的脚本文件中，通常为QManage.txt或QuestDiary目录下独立文件。脚本位置影响执行顺序和可维护性。
QManage.txt集成方式：在QManage.txt的登录触发段或地图触发段添加脚本标签。例如在[@Login]段后添加地图触发检测，但需注意QManage.txt执行频率较高，可能影响性能。
独立脚本文件方式：在QuestDiary目录创建专用文件，如“地图触发处理.txt”，内部定义[@进入皇宫处理]脚本段。MapEvent.txt中指向该文件路径，如“3 0 0 ..\QuestDiary\地图触发处理.txt @进入皇宫处理”。此方式结构清晰，便于管理多个地图触发脚本。
脚本文件编码和格式要求：文件保存为ANSI编码，避免UTF-8带BOM格式。每行命令以回车结束，避免多余空格。标签独占一行，格式为[@标签名]，方括号为英文符号。
跨地图传送宠物处理
玩家通过传送命令或NPC进入禁止宠物地图时，需确保触发正常执行。传送瞬间的宠物处理需特殊注意。
传送命令触发处理：在传送NPC脚本或传送命令执行后立即检测宠物状态。例如传送至皇宫的NPC脚本：
[@传送到皇宫]
#IF
#ACT
MAPMOVE 3 330 330
CHECKPET
#ACT
KILLPET
SENDMSG 5 提示：皇宫区域禁止宠物，您的宠物已被清除。
在MAPMOVE命令后直接添加宠物检测清除，确保传送完成立即处理。避免玩家利用传送间隙携带宠物进入。
随机传送卷和传送戒指处理：这些物品触发传送时可能绕过地图触发检测。需在物品使用脚本中添加宠物检查，或在地图触发中使用延迟检测确保捕捉。
延迟检测脚本示例：
[@进入皇宫处理]
#IF
#ACT
DelayCall 1000 @延迟宠物检查
[@延迟宠物检查]
#IF
CHECKPET
#ACT
KILLPET
SENDMSG 5 提示：本地图禁止携带宠物，您的宠物已被清除。
DelayCall命令延迟1秒后执行宠物检查，应对传送延迟情况。延迟时间根据实际情况调整，通常500-2000毫秒。
宠物重生与再次召唤防止
清除宠物后需防止玩家立即重新召唤，确保地图规则持续有效。通过状态标记或召唤冷却实现。
状态标记脚本：
[@进入皇宫处理]
#IF
CHECKPET
#ACT
KILLPET
SET [150] 1
SENDMSG 5 提示：本地图禁止携带宠物，您的宠物已被清除。
[@召唤宠物]
#IF
CHECKMAPNAME 皇宫
CHECK [150] 1
#ACT
SENDMSG 5 提示：皇宫区域内禁止召唤宠物。
BREAK
#ELSEACT
USESKILL 召唤宠物
SET [150] 1设置标志位，在宠物召唤脚本中检测该标志位和地图名称，阻止召唤。标志位在玩家离开地图时清除。
召唤技能冷却修改：修改召唤技能在特定地图的冷却时间，大幅延长召唤间隔。通过技能触发脚本实现：
[@MagicAttack]
#IF
CHECKCURRTARGETRACE = 0
CHECKMAPNAME 皇宫
#ACT
ChangeSkillCoolTime 召唤宠物 60000
SENDMSG 5 提示：皇宫区域内召唤宠物冷却时间延长至60秒。
ChangeSkillCoolTime命令修改技能冷却时间，此例将召唤宠物冷却设为60000毫秒。配合地图触发实现区域限制。
引擎兼容性与命令差异
不同传奇引擎对宠物相关命令支持存在差异，需根据引擎类型调整脚本。主流引擎包括GEE、GOM、V8等，命令语法略有不同。
GEE引擎宠物检测命令为CHECKPET，清除命令为KILLPET。支持CHECKPETNAME检测宠物名称，CHECKPETLEVEL检测宠物等级。地图触发配置在MapEvent.txt，格式为“地图编号 触发类型 参数 脚本文件路径 脚本标签”。
GOM引擎基本命令相似，但部分版本使用CHECKSLAVE代替CHECKPET检测宠物。清除命令可能为KILLSLAVE或RECALLSLAVE。需查阅对应引擎说明书确认命令格式。
V8引擎通常兼容GEE命令，但扩展更多宠物控制功能。如GetPetInfo获取宠物详细信息，SetPetLevel设置宠物等级。可根据需要增强脚本功能。
命令测试方法：在游戏中通过NPC脚本单独测试每个宠物相关命令，确认功能正常。使用SENDMSG输出检测结果，验证命令返回值。
脚本错误排查与调试
脚本部署后需测试功能，常见问题包括触发不执行、宠物检测失败、清除无效等。系统化排查确保脚本正常运行。
触发不执行检查MapEvent.txt配置：确认地图编号正确，触发类型为0（进入触发），脚本路径和标签准确。重启服务器使配置生效，MapEvent.txt修改需重读地图事件或重启M2。
宠物检测失败检查命令权限：某些引擎需开启宠物检测功能，在M2控制台查看相关选项。确认玩家宠物为召唤类型而非跟随类型，检测命令可能只对召唤宠物有效。
清除无效检查宠物类型：KILLPET命令可能对某些特殊宠物无效，如任务宠物或活动宠物。尝试使用RECALLPET命令强制召回宠物。检查引擎限制，部分引擎限制清除高级宠物。
调试信息输出：在脚本关键点添加SENDMSG输出调试信息，如“进入触发执行”、“检测到宠物”、“清除命令执行”。通过输出信息定位脚本执行断点。
日志记录分析：开启引擎脚本执行日志，查看地图触发和脚本执行记录。M2控制台通常显示脚本错误信息，根据提示修正语法错误。
高级应用与功能扩展
基础禁止宠物功能可扩展为更复杂的地图规则系统，结合其他限制条件实现精细化控制。
结合玩家等级和职业限制：高等级玩家或特定职业可豁免宠物限制。脚本示例：
[@进入皇宫处理]
#IF
CHECKPET
CHECKLEVELEX > 50
#ACT
SENDMSG 5 提示：您等级超过50级，允许携带宠物进入皇宫。
BREAK
#IF
CHECKPET
CHECKJOB Warrior
#ACT
SENDMSG 5 提示：战士职业允许携带宠物进入皇宫。
BREAK
#IF
CHECKPET
#ACT
KILLPET
SENDMSG 5 提示：本地图禁止携带宠物，您的宠物已被清除。
CHECKLEVELEX检测玩家等级，CHECKJOB检测职业，满足条件时跳过清除。
时间周期限制：特定时间段内禁止宠物，其他时间允许。结合系统时间检测实现：
[@进入皇宫处理]
#IF
CHECKPET
CHECKHOUR 20 22
#ACT
KILLPET
SENDMSG 5 提示：20点至22点活动期间禁止携带宠物进入。
#ELSEACT
SENDMSG 5 提示：当前时段允许携带宠物进入。
CHECKHOUR检测当前小时是否在20-22点范围内，实现分时段限制。
宠物寄存系统：清除宠物前提供寄存选项，离开地图时归还。复杂脚本需配合变量存储宠物信息，实现临时寄存功能。
地图区域差异化规则：同一地图不同坐标区域适用不同宠物规则。通过坐标检测实现精细化控制，如皇宫入口允许宠物，王座附近禁止。使用CHECKPOS命令检测玩家坐标，应用不同规则。
通过合理配置地图触发事件，编写完善的宠物检测处理脚本，可实现传奇地图禁止携带宠物功能。注意引擎命令差异，充分测试确保脚本稳定，根据实际需求扩展功能，构建符合游戏规则的地图环境。
