**在Hero引擎中实现地图禁止携带宠物的功能主要通过地图参数触发和机器人定时扫描两种机制来完成**
传奇游戏里很多高难度地图或特殊活动地图都设有禁止携带宠物的规则。如果玩家带着宝宝进入这类地图，通常会被强制传送回城或者宝宝直接被清除。这种机制既能维护地图的挑战性，也能避免宠物过多造成的服务器卡顿。对于服务器管理者而言，掌握禁宠脚本的触发方法是一项基础且实用的技能。
**一、禁宠脚本触发的核心逻辑与实现思路**
实现地图禁带宠物的功能，核心逻辑其实很简单：要么在玩家进入地图的那一刻进行检测并处理，要么在地图内部持续不断地扫描并清理违规携带的宠物。
这两种思路对应着两种不同的触发方式。第一种是进入地图时触发，通过在MapInfo.txt地图配置文件中为特定地图添加参数，让玩家传送进地图的瞬间执行一段检测脚本。第二种是定时扫描触发，通过机器人脚本AutoRunRobot每天定时或每隔几秒对目标地图内的所有玩家进行检测，发现有带宠物的就直接清除。
两种方式各有优劣。进入触发方式响应快，玩家还没站稳宝宝就被清理了，但缺点是如果玩家在死亡后小退再上线直接出现在地图内，可能绕过进入触发。定时扫描方式覆盖面广，任何漏网之鱼都会被扫出来，但缺点是扫描间隔时间内玩家可能已经带着宝宝打了一会儿怪。最稳妥的做法是把两种方式结合起来使用。
**二、进入触发方式：MapInfo.txt地图参数配置**
进入触发的实现需要在MapInfo.txt文件中为目标地图添加参数，让玩家进入时自动跳转至指定的Quest脚本。
MapInfo.txt文件通常位于Mir200\Envir目录下。用记事本打开该文件，找到想要设置禁宠的地图配置行。例如皇宫地图的配置行可能是[D703 皇宫]，如果想在这个地图实现进入禁宠，就在后面添加参数：
[D703 皇宫] CHECKQUEST(Q001)
这里的Q001是脚本名称代号，对应着QuestDiary目录下的一个文本文件。实际使用时可以根据需要命名，比如禁宠脚本可以叫NOPET或KILLSLAVE。
添加完地图参数后，需要在Mir200\Envir\QuestDiary目录下新建一个文本文件，文件名必须与参数中的代号对应。如果是Q001，就新建一个Q001.txt文件。
在Q001.txt中写入具体的脚本内容：
[@MAIN]
#IF
CHECKSLAVECOUNT > 0
#ACT
KILLSLAVE
MAPMOVE D703 333 333
SENDMSG 5 检测到你携带宠物，已自动清除！
#ELSEACT
SENDMSG 5 欢迎进入皇宫，请遵守游戏规则。
这段脚本的逻辑是：检测玩家宠物数量是否大于0，如果是则执行KILLSLAVE命令清除所有宠物，然后用MAPMOVE命令将玩家移动到地图内的指定坐标，同时发送提示信息。如果没带宠物，则只发送欢迎信息。
CHECKSLAVECOUNT是Hero引擎中专门用于检测宠物数量的命令，支持大于、小于、等于等比较符。KILLSLAVE命令则负责清除玩家当前拥有的所有宠物。
**三、定时扫描方式：AutoRunRobot机器人脚本配置**
定时扫描方式适用于那些已经被玩家混进去带宠物的场景，或者在进入触发失效的情况下作为补救措施。
首先要在Mir200\Envir\Robot_def目录下找到AutoRunRobot.txt文件。这个文件负责定义机器人脚本的执行时间。在文件中添加如下内容：
#AutoRun NPC SEC 10 @CheckPetMap
这行命令的意思是每隔10秒执行一次名为@CheckPetMap的脚本段。时间间隔可以根据服务器负载情况调整，如果地图重要且禁止宠物要求严格，可以设置更短的间隔如5秒。
然后在同一目录下的RobotManage.txt文件中，编写具体的执行逻辑：
[@CheckPetMap]
#IF
#ACT
MOV M0 0
MOV S0 D703
GMEXECUTE 开始提问 @ClearPetInMap
这段脚本的作用是设置变量M0初始值为0，将D703赋值给S0变量，然后调用GMEXECUTE命令开始执行针对D703地图的清除操作。
接下来需要在QFunction-0.txt或RobotManage.txt中继续编写实际的清除逻辑。常用的写法是：
[@ClearPetInMap]
#IF
#ACT
GETALLPLAYERS
#CALL [ClearPetScript.txt] @ClearPetMain
GETALLPLAYERS命令用于获取当前地图内的所有玩家列表，然后调用子脚本ClearPetScript.txt中的@ClearPetMain段进行逐人检测。
在ClearPetScript.txt中编写：
[@ClearPetMain]
#IF
#ACT
GOTO @CheckPlayerPet
[@CheckPlayerPet]
#IF
CHECKSLAVECOUNT > 0
#ACT
KILLSLAVE
SENDMSG 5 你在皇宫地图携带宠物，已被系统清除！
SENDMSG 0 玩家【%s】在皇宫地图违规携带宠物，已被强制清除！
这段脚本会对每个玩家执行宠物数量检测，发现大于0则清除并发送提示信息。
**四、触发脚本的灵活变体与进阶应用**
除了上述基础实现，禁宠脚本还可以根据不同的运营需求进行调整和扩展。
有的版本希望把带宠物的玩家直接传送出地图而非原地清除，这样可以起到惩戒作用。实现方法很简单，把MAPMOVE命令的目标坐标改成其他安全区坐标即可：
[@MAIN]
#IF
CHECKSLAVECOUNT > 0
#ACT
KILLSLAVE
MAPMOVE 3 330 330
SENDMSG 5 皇宫禁止携带宠物，你已被传送至土城！
有的版本希望区分不同类型的宠物。比如道士的召唤神兽是合法宠物，而某些特殊活动获得的宠物才需要禁止。这需要结合CHECKSLAVETYPE命令进行精确控制，但Hero引擎原生命令中并未直接提供该功能，需要配合变量和自定义标识实现。
还有的版本希望给玩家一个缓冲时间，比如进入地图前弹出提示框让玩家手动解散宠物，30秒内未解散则强制处理。这需要用到NPC对话框和计时器功能，代码相对复杂，但原理仍然是基于宠物数量检测。
**五、配合使用QF触发脚本实现更严密的防护**
除了地图参数和机器人脚本，QFunction-0.txt中的触发段也可以用来辅助实现禁宠功能。
例如，[@PlayInMap]触发段可以在玩家进入任何地图时执行脚本。在这个段里添加对特定地图的检测，可以起到和MapInfo参数类似的作用：
[@PlayInMap]
#IF
ISINMAP D703
CHECKSLAVECOUNT > 0
#ACT
KILLSLAVE
SENDMSG 5 你带着宠物进入皇宫，已被自动清除！
这种写法的优势是可以统一管理所有地图的进入检测，而不需要为每个地图单独添加CHECKQUEST参数。缺点是在玩家进入非目标地图时也会进行检测，增加了一点不必要的资源消耗。
另外，[@Login]触发段也可以发挥作用。如果玩家之前在禁宠地图内下线，上线时直接出现在地图里，[@Login]段可以检测到并处理：
[@Login]
#IF
ISINMAP D703
CHECKSLAVECOUNT > 0
#ACT
KILLSLAVE
SENDMSG 5 检测到你在地图内携带宠物，已强制清除！
**六、涉及的核心脚本命令详解**
实现禁宠功能需要用到几个关键的Hero引擎脚本命令。
CHECKSLAVECOUNT是检测宠物数量的核心命令。格式为CHECKSLAVECOUNT 操作符 数值，例如CHECKSLAVECOUNT > 0表示检测宠物数量是否大于0。这个命令返回真或假，用于#IF条件下的判断。
KILLSLAVE是执行清除宠物的命令。该命令不需要参数，直接执行即可杀死玩家当前召唤的所有宠物。需要注意的是，这个命令只能清除普通宠物，对于某些特殊版本中的英雄或分身可能无效，需要用其他命令处理。
MAPMOVE用于将玩家传送到指定地图的指定坐标。格式为MAPMOVE 地图号 X Y。在禁宠脚本中，通常用于将带宠物的玩家传送到安全区或者重新传回目标地图内。
GETALLPLAYERS和GMEXECUTE这两个命令通常配合使用，用于获取地图内所有玩家并对每个玩家执行特定操作。在机器人脚本的循环检测中非常实用。
SENDMSG是发送消息的命令，后面跟数字表示消息类型，5表示发送到玩家私聊窗口，0表示发送到公屏。
**七、实战测试与常见问题排查**
脚本编写完成后，需要进行实际测试确保功能正常。
测试时可以先用道士号召唤一个宝宝，然后尝试通过传送NPC进入设置了禁宠的地图。如果进入触发脚本配置正确，应该会看到宝宝瞬间消失，同时屏幕中央或聊天框弹出提示信息。如果进入后宝宝还在，说明进入触发部分没有生效，需要检查MapInfo.txt的格式是否正确，QuestDiary目录下的脚本文件名是否与参数一致，脚本内容是否有语法错误。
定时扫描部分的测试稍微复杂一些。可以先带着宝宝直接飞到目标地图内，然后观察10秒后宝宝是否被清除。如果没反应，检查AutoRunRobot.txt中的时间设置是否正确，RobotManage.txt中的地图号是否正确，以及子脚本路径和文件名是否匹配。
常见的问题包括：中文符号误用导致脚本不识别、地图号填写错误、脚本文件名与调用名不一致、KILLSLAVE命令在某些版本中需要权限等。逐项排查通常能找到问题所在。
如果希望脚本只针对特定地图生效，务必在每个检测段中加入ISINMAP地图号的条件判断，避免误伤其他地图的玩家。
**八、多地图批量管理的配置技巧**
如果服务器中有多个地图需要设置禁宠，逐个添加CHECKQUEST参数和对应的脚本会比较繁琐。这时可以采用统一的处理方式。
在MapInfo.txt中，可以为每个需要禁宠的地图添加相同的参数，比如[D703 皇宫] CHECKQUEST(NoPetMap)，[D704 擂台] CHECKQUEST(NoPetMap)。然后只创建一个NoPetMap.txt脚本文件。
在NoPetMap.txt中，不需要再区分地图，直接写：
[@MAIN]
#IF
CHECKSLAVECOUNT > 0
#ACT
KILLSLAVE
SENDMSG 5 本地图禁止携带宠物，你的宝宝已被清除！
这样所有调用NoPetMap的地图都会执行相同的处理逻辑。如果不同地图需要不同的处理方式，可以在脚本内通过ISINMAP命令进行区分。
定时扫描方式也可以用类似思路，将多个地图号存入变量，循环处理每个地图。
通过以上方法，Hero引擎的服务端管理者可以完整实现地图禁止携带宠物的功能，既可以在玩家进入时立即拦截，也可以通过定时扫描清除漏网之鱼，确保游戏规则的有效执行。
