架设传奇服务器：sky 引擎限制宠物数量的完整脚本编写指南与实例

在传奇服务器架设中，宠物系统的合理设置直接影响游戏平衡。许多架设者通过商铺添加宠物召唤卷后，会遇到玩家可无限召唤宠物的问题 —— 使用 10 张召唤卷就能召唤 10 个宠物，这显然破坏了游戏体验。针对 sky 引擎（又称 HeroM2 引擎），本文将详细介绍如何编写限制宠物数量的脚本，实现 “无论使用多少召唤卷，玩家最多只能拥有 1 个宠物” 的效果，包括核心函数解析、完整脚本实例及调试技巧。
核心函数与引擎特性解析
要编写限制宠物数量的脚本，首先需掌握 sky 引擎中与宠物相关的核心函数及判断机制。在 sky 引擎的脚本系统中，检查玩家当前宠物数量的关键函数是CheckPetCount，其基本语法为CheckPetCount <数值>，用于判断玩家当前召唤的宠物数量是否小于指定数值。该函数返回逻辑值，当条件成立时（即宠物数量小于指定数值），脚本会执行后续命令；不成立时则跳过。
与其他引擎不同，sky 引擎对宠物的定义包含 “主动召唤宠物”“雇佣 NPC”“临时召唤物” 等多种类型，CheckPetCount函数默认统计所有由玩家主动召唤的战斗宠物（如神兽、骷髅等），不包含临时怪物（如法师的雷电术召唤物）。这一点需特别注意 —— 若你的宠物系统包含特殊类型宠物，需在脚本中额外排除非战斗宠物类型，可通过CheckPetType函数辅助判断。
sky 引擎的脚本执行逻辑遵循 “条件判断→执行命令→反馈结果” 的流程。在商铺召唤卷的使用场景中，脚本需要先通过CheckPetCount判断玩家当前宠物数量，若小于 1 则执行召唤命令，若大于等于 1 则发送提示信息。此外，sky 引擎支持@RecallMob命令召唤指定宠物，@Message命令向玩家发送系统提示，这两个命令将作为脚本的核心执行语句。
需要注意的是，sky 引擎的不同版本对宠物函数的支持存在细微差异。2018 年之后的版本中，CheckPetCount函数可直接统计所有玩家控制的宠物数量，而早期版本可能需要结合GetPetCount函数获取数值后再进行比较。若你使用的是旧版引擎，需在脚本中增加数值获取步骤（如#VAR <变量名> <GetPetCount>），再通过CheckVar函数判断变量值。
完整脚本编写步骤
针对 “限制玩家最多拥有 1 个宠物” 的需求，脚本编写需分为三个核心部分：条件判断、执行召唤、异常提示。以下是分步编写指南：
第一步：条件判断部分（#IF 段）
在脚本的#IF区块中，需通过CheckPetCount函数判断玩家当前宠物数量是否小于 1。正确的写法为：
#IF
CheckPetCount 1

这里的CheckPetCount 1表示 “玩家当前宠物数量小于 1”，满足该条件时，脚本将进入#ACT区块执行召唤命令。若玩家已拥有 1 个或多个宠物，该条件不成立，脚本会直接跳至#ELSEACT区块执行提示命令。
需避免的常见错误：将CheckPetCount 1误写为CheckPetCount <1或CheckPetCount =0。在 sky 引擎中，CheckPetCount函数的参数直接代表 “小于该数值”，无需添加比较运算符，写为CheckPetCount 1即可正确判断宠物数量为 0 的情况。
第二步：执行与反馈部分（#ACT 与 #ELSEACT 段）
当条件判断成立（玩家无宠物）时，#ACT区块需执行召唤宠物的命令；不成立时，#ELSEACT区块需向玩家发送 “已拥有宠物，无法再次召唤” 的提示。结合商铺召唤卷的使用场景，完整代码如下：
#IF
CheckPetCount 1
#ACT
@RecallMob 宝宝 1 0 0
@Message 2 0 宠物召唤成功，当前拥有1个宠物
#ELSEACT
@Message 2 0 你已经拥有宠物，无法再次召唤

其中，@RecallMob命令的参数依次为 “宠物名称”“数量”“X 坐标偏移”“Y 坐标偏移”，这里宝宝是宠物的名称（需与怪物数据库中的名称一致），1表示召唤 1 个，0 0表示宠物出现在玩家当前坐标。@Message命令中，2代表消息颜色为红色，0表示发送范围为玩家本人，后续文本为提示内容。
第三步：脚本整合与商铺关联
编写完成的脚本需要与商铺中的宠物召唤卷关联。在 sky 引擎中，商铺物品的使用逻辑通常通过Shop.txt或QuestDiary\Shop目录下的对应脚本文件控制。找到宠物召唤卷的物品脚本，将上述限制宠物数量的代码嵌入其使用流程中，具体步骤为：
打开商铺物品配置文件（通常为Mir200\Envir\Market_Def\Shop.txt），找到宠物召唤卷的物品 ID 及对应脚本路径。
在该物品的使用脚本中，将限制宠物数量的代码添加到使用逻辑的最前端，确保先判断宠物数量，再执行后续操作。
保存文件后，通过引擎控制台执行@ReloadShop命令重载商铺配置，使脚本生效。
脚本测试与调试技巧
编写完成的脚本需经过严格测试才能确保生效，以下是针对 sky 引擎的测试与调试方法：
基础测试流程
登录游戏创建测试账号，确保背包中无宠物且未召唤任何宠物。
从商铺购买 1 张宠物召唤卷并使用，观察是否成功召唤宠物，且系统提示 “召唤成功”。
再次购买 1 张召唤卷使用，检查是否收到 “已拥有宠物” 的提示，且未出现新宠物。
手动解散现有宠物（通过@ReleasePet命令或游戏内操作），再使用召唤卷，确认能否重新召唤宠物。
常见问题排查
若测试时出现 “条件判断失效”（已拥有宠物仍能召唤），需检查以下几点：
脚本中CheckPetCount函数是否误写为CheckPetCount 0（这会导致 “宠物数量小于 0” 的永假条件）。
宠物名称是否与怪物数据库（Mir200\Envir\MonItems.txt）中的名称一致，名称错误会导致召唤失败但不影响数量判断。
引擎是否开启了 “宠物数量无限制” 的特殊设置，可在M2Server的 “参数设置→宠物设置” 中检查 “最大宠物数量” 是否为 1。
若出现 “提示信息不显示”，需检查@Message命令的参数是否正确：颜色值需在 1-255 之间，范围值设为 0 代表仅玩家可见，文本部分不能包含特殊符号（如# $等）。
进阶调试工具
利用 sky 引擎的脚本调试功能可快速定位问题：
在M2Server界面中开启 “脚本调试模式”（路径：查看→调试信息→脚本调试）。
执行宠物召唤操作时，控制台会输出脚本执行过程，包括 “条件判断结果”“执行的命令” 等信息。
根据调试信息中的 “条件不成立” 或 “命令执行失败” 提示，针对性修改脚本。
扩展技巧与兼容处理
除基础限制功能外，可根据游戏需求扩展脚本功能，同时确保与其他系统兼容：
多场景适配
若需要区分 “不同地图的宠物限制”（如某些地图禁止召唤宠物），可在条件判断中增加地图检查函数：
#IF
CheckMapName 安全区
CheckPetCount 1
#ACT
@RecallMob 宝宝 1 0 0
#ELSEACT
@Message 2 0 当前地图禁止召唤宠物或已拥有宠物

其中CheckMapName 安全区用于判断玩家是否在指定地图，多个地图可使用CheckMapList函数批量判断。
与宠物等级关联
若需要 “玩家等级达到指定值才能召唤宠物”，可添加等级判断函数：
#IF
CheckLevel 30
CheckPetCount 1
#ACT
@RecallMob 宝宝 1 0 0
#ELSEACT
@Message 2 0 等级不足30级或已拥有宠物

引擎版本兼容
对于 sky 引擎的早期版本（2015 年前），CheckPetCount函数可能无法直接使用，此时可通过GetPetCount函数获取宠物数量后再判断：
#VAR PetNum <GetPetCount>
#IF
CheckVar PetNum 0
#ACT
@RecallMob 宝宝 1 0 0
#ELSEACT
@Message 2 0 已拥有宠物，无法再次召唤

这种写法通过变量存储宠物数量，再通过CheckVar函数判断变量值是否为 0，兼容旧版引擎的语法要求。
总结与注意事项
编写限制宠物数量的脚本核心在于正确运用CheckPetCount函数进行条件判断，结合@RecallMob和@Message命令实现召唤与提示功能。在实际架设中，需注意以下几点：
脚本编写后必须重载配置（@ReloadScript或重启引擎）才能生效。
宠物名称必须与怪物数据库完全一致，包括大小写（sky 引擎对名称大小写敏感）。
若游戏中有多种宠物类型，需在脚本中增加类型判断，避免不同宠物类型之间的限制冲突。
通过本文介绍的方法，即可在 sky 引擎下架设出 “限制玩家最多拥有 1 个宠物” 的功能，既满足商铺召唤卷的正常使用，又能维持游戏平衡。随着对脚本逻辑的熟悉，还可进一步扩展功能，如设置不同 VIP 等级对应不同宠物数量上限，或根据地图动态调整限制规则，为玩家带来更丰富的游戏体验。记住，脚本编写的关键在于理解引擎函数的特性，通过逐步测试验证每一个条件与命令的执行效果。