一、传奇封挂脚本核心定位及适用场景
传奇封挂脚本是通过脚本命令检测玩家异常行为、限制违规操作、处罚违规账号的专用脚本，核心作用是识别各类违规行为，包括自动挂机、加速移动、自动释放技能、多开账号、异常拾取等，通过预设规则实现自动检测、自动提示、自动处罚，维护游戏内公平环境。
封挂脚本可适配所有主流传奇引擎，包括GOM、GEE、Hero、旭玩等，无需额外安装插件，直接在服务端脚本文件中编写即可生效，核心适配场景包括全服全局检测、指定地图检测、特定行为检测，可根据游戏运营需求，灵活设置检测精度和处罚力度。
封挂脚本核心依赖服务端脚本解析，与普通功能脚本共用相同的存放路径和编写格式，无需专业编程基础，掌握核心检测命令和逻辑，即可完成基粹挂脚本编写，复杂封挂需求可通过多脚本协同实现。
二、传奇封挂脚本核心编写基础（必学）
封挂脚本编写遵循传奇脚本通用格式，核心分为检测段、执行段、否则段，所有封挂逻辑均围绕“检测异常行为-执行处罚操作”展开，核心编写规范和基础命令如下，适用于所有类型封挂脚本。
1.核心编写格式
封挂脚本核心格式与普通脚本一致，重点在于检测段的异常行为判断，执行段的处罚操作，格式如下，可根据检测需求省略否则段：
#IF
//检测段：设置违规行为判断条件，可单个条件或多个条件叠加，多个条件同时满足则判定为违规
#ACT
//执行段：违规判定成立后，执行的处罚操作，如弹出提示、传送至指定地图、扣除道具、禁止登录等
#ELSEACT
//否则段：未检测到违规行为时，执行的操作，通常省略，省略后无任何反应
BREAK
//终止脚本执行，避免重复检测、重复处罚，每个完整封挂脚本段末尾必须添加
补充说明：多条件检测时，需在检测段依次编写所有条件，引擎会自动判断所有条件是否同时满足，任意一个条件不满足则不执行处罚操作；若需满足任意一个条件即判定违规，需拆分多个独立脚本段。
2.封挂脚本核心命令（必备）
封挂脚本核心依赖检测命令和处罚命令，所有命令严格区分大小写，命令结尾需加英文“;”，部分引擎支持扩展命令，基础命令适配所有主流引擎，核心命令分类如下：
（1）异常行为检测命令
此类命令用于检测玩家各类违规行为，是封挂脚本的核心，常用命令及用法如下：
①CheckSpeed>N：检测玩家移动速度，N为正常最大速度值（单位：像素/秒），大于N则判定为加速违规，例如CheckSpeed>150，检测玩家移动速度是否超过150像素/秒。
②CheckAttackSpeed>N：检测玩家攻击速度，N为正常最大攻击速度值，大于N则判定为攻击加速违规，适配所有职业，可根据职业差异设置不同N值。
③CheckSkillSpeed>N：检测玩家技能释放速度，N为正常最大技能速度值，大于N则判定为技能加速违规，常用于检测自动技能脚本。
④CheckMultiLoginN：检测玩家多开账号数量，N为允许多开的最大数量，大于N则判定为多开违规，例如CheckMultiLogin1，禁止玩家多开账号（仅允许单开）。
⑤CheckAutoPick：检测玩家是否开启自动拾取功能，无需设置参数，检测到自动拾取即判定为违规，适用于禁止自动拾取的场景。
⑥CheckAutoFight：检测玩家是否开启自动战斗功能，无需设置参数，检测到自动战斗（自动打怪、自动释放技能）即判定为违规，是最常用的挂机检测命令。
⑦CheckMapStayTime地图IDN：检测玩家在指定地图的停留时间，N为最长允许停留时间（单位：秒），超过N秒且无手动操作则判定为挂机违规，例如CheckMapStayTime5300，检测玩家在地图ID为5的地图停留超过300秒是否违规。
⑧CheckNoOperateN：检测玩家无操作时间，N为最长允许无操作时间（单位：秒），超过N秒则判定为挂机违规，适用于全服全局挂机检测。
⑨CheckItemUseSpeed物品IDN：检测玩家使用指定物品的速度，N为正常最大使用速度（单位：次/秒），大于N则判定为违规，常用于检测自动吃药、自动使用道具的脚本。
（2）处罚执行命令
此类命令用于违规行为判定后，执行具体处罚操作，可根据违规严重程度设置不同处罚，常用命令及用法如下：
①SendMsg颜色代码提示内容：在玩家游戏界面弹出违规提示，颜色代码推荐5（红色）、255（金色），提示内容需清晰明确，例如SendMsg5检测到违规操作，即将进行处罚！;
②MapMove地图ID坐标X坐标Y：将违规玩家传送到指定地图（如禁闭室、安全区），例如MapMove10300300，将违规玩家传送到地图ID为10的禁闭室。
③Take物品ID数量：扣除违规玩家指定道具，作为轻度处罚，例如Take金币100000，扣除违规玩家10万金币。
④ChangeLevelN：修改违规玩家等级，N为目标等级，可用于降级处罚，例如ChangeLevel1，将违规玩家等级降至1级。
⑤BanLoginN：禁止违规玩家登录，N为禁止登录时间（单位：分钟），例如BanLogin120，禁止玩家登录2小时；N=0时，永久禁止登录。
⑥ClearPkPoint：清除违规玩家PK值，适用于违规行为伴随恶意PK的场景，可搭配其他处罚使用。
⑦SendBroad颜色代码公告内容：全服发送违规公告，警示所有玩家，例如SendBroad5玩家XXX因违规挂机，已被处罚，请各位玩家规范游戏行为！;
⑧CloseClient：强制关闭违规玩家游戏客户端，适用于严重违规场景，例如多次违规、使用恶性脚本的玩家。
（3）辅助检测命令
此类命令用于辅助检测，提升封挂脚本的准确性，避免误判，常用命令及用法如下：
①IsOnMap地图ID：检测玩家是否在指定地图内，搭配其他检测命令使用，实现指定地图封挂检测，例如仅检测某副本内的违规行为。
②CheckLevelN：检测玩家等级，N为目标等级，可用于区分等级检测，例如仅检测等级≥50级玩家的违规行为，避免误判新手玩家。
③CheckVipLevelN：检测玩家VIP等级，N为目标VIP等级，可用于设置VIP玩家特殊检测规则（如放宽检测精度）。
④CheckGuild行会名称：检测玩家所属行会，可用于针对特定行会的违规检测，适配行会违规管控场景。
3.编写注意细节
①编码格式：所有封挂脚本文件必须设置为ANSI编码，右键点击脚本文件-打开方式-记事本-文件-另存为，编码选择ANSI，保存覆盖原有文件，否则会出现乱码，导致引擎无法解析脚本。
②命令规范：每行只能编写一条脚本命令，不可多行合并，命令结尾必须加英文“;”，禁止使用中文标点（逗号、句号、问号等），否则会触发语法错误，导致脚本无效。
③命令大小写：所有脚本命令（#IF、#ACT、CheckSpeed、SendMsg等）必须严格区分大小写，不可写为小写（如#if、#act、checkspeed），否则引擎无法识别命令。
④检测精度：设置检测参数（如速度值、停留时间）时，需结合自身游戏设置，参考正常玩家行为数据，避免参数设置过低导致误判，过高导致无法检测到违规行为。
⑤脚本路径：封挂脚本需存放在对应脚本文件夹内，全局封挂脚本存放在Mirserver\Mir200\Envir\MapQuest_def\QManage.txt，指定地图或NPC相关封挂脚本存放在Market_Def或QuestDiary文件夹。
⑥避免冲突：封挂脚本与其他功能脚本（如任务脚本、NPC脚本）需避免变量、命令冲突，自定义变量名称不可用P、D、M、N、S、I、G、A开头，变量使用时需全部大写。
三、传奇封挂脚本实操编写（分场景）
结合游戏常见违规场景，编写可直接复制使用的封挂脚本，涵盖全局挂机检测、加速检测、多开检测、自动拾取检测等核心场景，新手可直接复制粘贴，修改参数即可生效。
1.全服全局挂机检测脚本（最常用）
核心作用：检测全服玩家无操作时间，超过设定时间判定为挂机违规，执行轻度处罚，适用于所有地图，存放在QManage.txt文件中，追加编写即可。
脚本内容：
#IF
CheckNoOperate300//检测玩家无操作时间超过300秒（5分钟），可根据需求修改时间
CheckLevel>10//排除等级≤10级的新手玩家，避免误判
#ACT
SendMsg5检测到您长时间无操作，已判定为挂机违规，将传送至安全区！;
MapMove3330330//传送至地图ID为3的安全区（可修改地图ID和坐标）
Take金币50000//扣除5万金币作为处罚（可修改道具和数量）
BREAK
补充说明：若需加重处罚，可添加BanLogin30（禁止登录30分钟）、ChangeLevel-5（等级降5级）等命令，根据违规严重程度调整。
2.加速行为检测脚本（针对移动、攻击加速）
核心作用：检测玩家移动速度、攻击速度是否超过正常范围，判定为加速违规，执行中度处罚，适用于全服检测，存放在QManage.txt文件中。
脚本内容：
//移动加速检测
#IF
CheckSpeed>150//正常移动速度最大为150像素/秒，可根据自身游戏设置修改
#ACT
SendMsg5检测到您使用加速功能，已违规，将强制传送至禁闭室！;
MapMove10300300//传送至地图ID为10的禁闭室
BanLogin60//禁止登录60分钟
SendBroad5玩家<$USERNAME>因使用加速功能违规，已被处罚，请规范游戏行为！;
BREAK
//攻击加速检测
#IF
CheckAttackSpeed>20//正常攻击速度最大为20，可根据职业差异调整
#ACT
SendMsg5检测到您使用攻击加速，已违规，将扣除对应道具并禁登！;
Take元宝10//扣除10元宝（可替换为其他道具）
BanLogin60
BREAK
3.多开账号检测脚本
核心作用：检测玩家多开账号数量，超过允许数量判定为违规，执行重度处罚，适用于禁止多开的场景，存放在QManage.txt文件中。
脚本内容：
#IF
CheckMultiLogin1//仅允许单开，超过1个账号即判定为违规
#ACT
SendMsg5检测到您多开账号，已违规，将强制关闭所有客户端并禁登！;
CloseClient//强制关闭客户端
BanLogin120//禁止登录120分钟
SendBroad5玩家<$USERNAME>因多开账号违规，已被处罚，严禁多开！;
BREAK
4.自动拾取、自动战斗检测脚本
核心作用：检测玩家是否开启自动拾取、自动战斗功能，判定为挂机违规，执行轻度至中度处罚，适用于副本、打怪地图，可存放在QManage.txt或对应地图脚本中。
脚本内容：
//自动拾取检测
#IF
CheckAutoPick//检测自动拾取功能
IsOnMap5//仅检测地图ID为5的副本（可修改地图ID或删除此句，实现全服检测）
#ACT
SendMsg5检测到您开启自动拾取，已违规，请关闭后继续游戏！;
Take金币30000//扣除3万金币
BREAK
//自动战斗检测
#IF
CheckAutoFight//检测自动战斗功能
CheckMapStayTime5180//检测在地图ID为5的副本停留超过180秒且自动战斗
#ACT
SendMsg5检测到您开启自动战斗挂机，已违规，将传送至安全区并禁登！;
MapMove3330330
BanLogin30
BREAK
5.特定地图封挂脚本（副本、活动地图专用）
核心作用：针对副本、活动等特定地图，设置更严格的封挂规则，检测各类违规行为，执行重度处罚，存放在QManage.txt文件中，绑定指定地图ID即可。
脚本内容：
#IF
IsOnMap8//仅检测地图ID为8的活动地图
CheckNoOperate120//无操作超过120秒（2分钟）判定违规
ORCheckAutoFight//或检测到自动战斗，任意一个条件满足即违规（OR表示或逻辑）
ORCheckSpeed>140//或检测到移动加速
#ACT
SendMsg5活动地图禁止挂机、加速，您已违规，将移出活动地图并扣除奖励！;
MapMove3330330//移出至安全区
Take活动积分100//扣除活动积分（可替换为活动道具）
BanLogin30
BREAK
补充说明：OR逻辑用于多个条件任意一个满足即判定违规，适用于特定地图多违规行为同时检测，可根据需求添加或删除检测条件。
四、封挂脚本存放路径及生效方法
封挂脚本需存放在对应服务端脚本文件夹内，不同类型的封挂脚本存放路径不同，生效方法也略有差异，具体如下，新手可按路径直接存放，避免路径错误导致脚本无效。
1.全局封挂脚本（全服检测）
存放路径：Mirserver\Mir200\Envir\MapQuest_def\QManage.txt
生效方法：打开QManage.txt文件，在文件末尾追加编写封挂脚本，保存文件后，重启M2引擎（M2Server.exe），关闭M2、DBserver、网关，重新启动后即可生效，无需修改其他文件。
注意：QManage.txt是全局触发脚本核心文件，追加封挂脚本时，需避免覆盖原有脚本内容，建议在文件末尾单独划分封挂脚本区域，便于后续修改和维护。
2.特定地图封挂脚本（指定地图检测）
存放路径：Mirserver\Mir200\Envir\MapQuest_def，新建文本文档，命名为“Map_地图ID.txt”（例如Map_5.txt，对应地图ID为5的地图），编写对应地图的封挂脚本。
生效方法：编写完成后保存文件，重启M2引擎，即可实现指定地图的封挂检测，脚本仅对该地图内的玩家生效，不影响其他地图。
3.NPC关联封挂脚本（触发式检测）
存放路径：Mirserver\Mir200\Envir\Market_Def或QuestDiary文件夹，新建文本文档，编写封挂脚本，命名无严格要求（如FengGua.txt）。
生效方法：在NPC.txt文件中添加对应NPC，设置NPC关联该封挂脚本，玩家点击NPC时触发封挂检测，适用于触发式封挂场景（如进入副本前检测），添加NPC后需重启服务端生效。
4.机器人辅助封挂脚本（定时检测）
存放路径：Mirserver\Mir200\Envir\Robot_def，在AutoRunRobot.txt和RobotManage.txt中编写定时检测脚本。
生效方法：在AutoRunRobot.txt中设置定时检测频率（如每10秒检测一次），在RobotManage.txt中编写具体封挂检测逻辑，保存后重启M2引擎，即可实现定时全服封挂检测，提升检测效率。
示例：AutoRunRobot.txt中添加#AutoRunNPCSEC10@FengGuaCheck，RobotManage.txt中编写@FengGuaCheck对应的封挂检测脚本，实现每10秒全服检测一次。
五、封挂脚本常见异常及排查解决
封挂脚本编写或存放错误，会导致脚本无效、误判、服务端报错等问题，核心异常及排查解决方法如下，逐一排查即可快速解决，无需复杂操作。
1.脚本无效，无法检测到违规行为
症状：编写封挂脚本后保存、重启引擎，玩家进行违规操作（如挂机、加速），无任何提示和处罚，服务端控制台无报错，脚本无法生效。
排查解决步骤：
①核对存放路径：确认封挂脚本存放在对应文件夹内，全局脚本存放在QManage.txt，指定地图脚本存放在MapQuest_def文件夹，路径错误会导致引擎无法加载脚本。
②检查脚本格式：核对脚本格式，确保#IF、#ACT、BREAK命令齐全，每行一条命令，命令结尾加英文“;”，无中文标点、无多余空格和空行。
③检查检测参数：确认检测参数（如速度值、无操作时间）设置合理，避免参数过高导致无法检测到违规行为，可适当降低参数测试（如将无操作时间从300秒改为180秒）。
④重启引擎：部分脚本修改后，仅重启M2引擎无效，需关闭M2、DBserver、网关，重新启动整个服务端，确保脚本完全加载。
⑤检查引擎设置：启动M2引擎，点击“功能设置-脚本设置”，确保“启用地图触发脚本”“启用QManage.txt脚本”已勾选，未勾选会导致脚本无法触发。
2.脚本误判，正常玩家被处罚
症状：正常玩家未进行任何违规操作，被封挂脚本判定为违规，弹出提示并执行处罚，影响玩家体验，多为检测参数设置不合理或脚本逻辑错误。
排查解决步骤：
①调整检测参数：适当提高检测参数（如移动速度从150改为160，无操作时间从180秒改为300秒），参考正常玩家行为数据，避免参数过低导致误判。
②添加排除条件：在检测段添加排除条件，如CheckLevel<10（排除新手玩家）、CheckVipLevel3（排除VIP3及以上玩家），减少误判概率。
③检查脚本逻辑：确认脚本中无逻辑错误，如多条件检测时误使用OR逻辑（应使用AND逻辑，多个条件同时满足才判定违规），修改逻辑后重新测试。
④测试验证：在测试服创建测试角色，模拟正常玩家操作（如正常移动、打怪、停留），测试脚本是否误判，调整参数至无误判后，再应用到正式服务端。
3.服务端控制台提示“未知脚本命令”
症状：启动服务端或玩家触发封挂脚本时，控制台弹出“未知脚本命令”提示，脚本无法执行，多为引擎不支持该封挂命令，常见于老旧引擎。
排查解决步骤：
①确认引擎版本：查看M2Server.exe属性，确认引擎类型和版本，老旧引擎（如0328、0538版本）不支持部分封挂命令（如CheckAutoPick、CheckMultiLogin）。
②替换兼容命令：将不支持的命令替换为基础兼容命令，例如用CheckMapStayTime和CheckNoOperate组合，替代CheckAutoFight，实现挂机检测；用其他检测方式替代CheckMultiLogin。
③升级引擎：若使用的是极低版本引擎，建议升级引擎包（推荐1108及以上版本），升级后支持所有封挂基础命令，同时重启服务端，重新添加脚本。
④核对命令拼写：确认所有命令拼写正确，严格区分大小写，例如将CheckSpeed误写为CheckSpead，会导致引擎无法识别，提示未知命令。
4.脚本冲突，导致其他功能脚本失效
症状：添加封挂脚本后，原有功能脚本（如任务脚本、NPC脚本）无法正常执行，服务端控制台无明显报错，多为封挂脚本与其他脚本存在变量、命令冲突。
排查解决步骤：
①定位冲突脚本：关闭所有封挂脚本，逐一启用，重启引擎测试，找到导致冲突的封挂脚本段落。
②修改变量名称：检查冲突脚本中的自定义变量，若与其他脚本重复，修改变量名称（避免用系统自带变量开头），变量使用时全部大写。
③调整脚本顺序：将封挂脚本移至QManage.txt文件末尾，避免与其他全局脚本冲突，或拆分封挂脚本，避免与其他脚本使用相同触发条件。
④简化脚本逻辑：删除封挂脚本中多余的命令，避免复杂逻辑与其他脚本冲突，保留核心检测和处罚命令即可。
5.脚本编码错误，出现乱码
症状：打开封挂脚本文件后，中文提示内容显示乱码，服务端控制台提示“无法识别的字符”，脚本无法执行，或执行后提示内容乱码。
排查解决步骤：
①修改编码格式：右键点击脚本文件，选择“打开方式-记事本”，点击“文件-另存为”，编码选择ANSI，保存覆盖原有文件，关闭记事本后重启服务端。
②重新编写脚本：若修改编码后仍有乱码，删除原有脚本，重新手动输入，避免复制粘贴导致的编码错乱，输入完成后保存，确保编码为ANSI。
③避免使用办公软件编辑：禁止使用Word、WPS等办公软件编辑封挂脚本，此类软件会自动修改编码格式，导致乱码，仅使用记事本编辑。
六、封挂脚本编写进阶技巧（提升检测效果）
基粹挂脚本可满足日常检测需求，若需提升封挂效果，减少漏判、误判，可使用以下进阶技巧，适配更复杂的违规场景，无需额外插件，仅通过脚本优化即可实现。
1.多条件叠加检测：将多个检测命令组合，提高检测准确性，例如CheckAutoFight+CheckMapStayTime+CheckNoOperate，三个条件同时满足才判定为挂机违规，避免误判正常玩家长时间停留。
2.分级处罚机制：根据违规次数、违规严重程度，设置不同处罚力度，例如首次违规扣除金币，二次违规禁登30分钟，三次违规永久禁登，可通过变量记录违规次数，实现分级处罚。
示例：用变量P0记录违规次数，首次违规P0=1，二次违规P0=2，根据P0的值执行不同处罚，脚本如下：
#IF
CheckAutoFight
CheckVarP0=0//首次违规
#ACT
SendMsg5首次违规，扣除5万金币，下次违规将加重处罚！;
Take金币50000
SetVarP01//设置违规次数为1
BREAK
#IF
CheckAutoFight
CheckVarP0=1//二次违规
#ACT
SendMsg5二次违规，禁登30分钟，三次违规将永久禁登！;
BanLogin30
SetVarP02//设置违规次数为2
BREAK
3.定时清理违规记录：通过机器人脚本，每天固定时间清理玩家违规次数变量（如每天0点清理P0变量），避免违规记录长期累积，脚本可在RobotManage.txt中编写。
4.特定职业适配：不同职业的正常速度、技能释放频率不同，可针对职业设置不同检测参数，例如战士攻击速度上限设为22，法师设为18，道士设为20，避免因职业差异导致误判。
5.结合引擎自带封挂功能：主流引擎（如旭玩引擎、GOM引擎）自带基粹挂功能，可开启引擎封挂功能，搭配自定义封挂脚本，实现双重检测，提升封挂效果，引擎封挂功能可在M2引擎“功能设置-封挂设置”中开启。
6.日志记录违规行为：在封挂脚本中添加日志记录命令，记录违规玩家名称、违规时间、违规类型，便于后续查询和管理，例如添加WriteLog封挂日志.txt玩家<$USERNAME>于<$TIME>因挂机违规被处罚；，日志文件会自动生成在服务端指定文件夹。
七、补充说明
1.封挂脚本编写后，需在测试服充分测试，模拟各类违规行为和正常玩家操作，确认无漏判、误判后，再应用到正式服务端，避免影响玩家体验。
2.定期更新封挂脚本，根据玩家违规行为变化，调整检测参数和检测逻辑，例如新增违规行为时，及时添加对应检测命令，提升封挂效果。
3.编写封挂脚本时，建议备份原有脚本文件，避免修改错误导致脚本损坏，同时备份封挂脚本，便于后续恢复和修改。
4.不同引擎的封挂命令略有差异，编写脚本前，可查看对应引擎的帮助文档，确认命令兼容性，避免使用不支持的命令，旭玩引擎、GOM引擎等主流引擎支持所有基粹挂命令。
5.封挂脚本不可过度严格，需平衡封挂效果和玩家体验，避免因检测参数过低、处罚过重，导致正常玩家流失，根据游戏运营需求合理调整。
6.若服务端出现PGStartAutoPickItem1等脚本相关报错，需检查MirServer/Mir2/Config目录下的GameGuard.ini文件，确保配置参数正确，同时检查封挂脚本，修复语法或逻辑错误。
传奇封挂脚本是通过脚本命令检测玩家异常行为、限制违规操作、处罚违规账号的专用脚本，核心作用是识别各类违规行为，包括自动挂机、加速移动、自动释放技能、多开账号、异常拾取等，通过预设规则实现自动检测、自动提示、自动处罚，维护游戏内公平环境。
封挂脚本可适配所有主流传奇引擎，包括GOM、GEE、Hero、旭玩等，无需额外安装插件，直接在服务端脚本文件中编写即可生效，核心适配场景包括全服全局检测、指定地图检测、特定行为检测，可根据游戏运营需求，灵活设置检测精度和处罚力度。
封挂脚本核心依赖服务端脚本解析，与普通功能脚本共用相同的存放路径和编写格式，无需专业编程基础，掌握核心检测命令和逻辑，即可完成基粹挂脚本编写，复杂封挂需求可通过多脚本协同实现。
二、传奇封挂脚本核心编写基础（必学）
封挂脚本编写遵循传奇脚本通用格式，核心分为检测段、执行段、否则段，所有封挂逻辑均围绕“检测异常行为-执行处罚操作”展开，核心编写规范和基础命令如下，适用于所有类型封挂脚本。
1.核心编写格式
封挂脚本核心格式与普通脚本一致，重点在于检测段的异常行为判断，执行段的处罚操作，格式如下，可根据检测需求省略否则段：
#IF
//检测段：设置违规行为判断条件，可单个条件或多个条件叠加，多个条件同时满足则判定为违规
#ACT
//执行段：违规判定成立后，执行的处罚操作，如弹出提示、传送至指定地图、扣除道具、禁止登录等
#ELSEACT
//否则段：未检测到违规行为时，执行的操作，通常省略，省略后无任何反应
BREAK
//终止脚本执行，避免重复检测、重复处罚，每个完整封挂脚本段末尾必须添加
补充说明：多条件检测时，需在检测段依次编写所有条件，引擎会自动判断所有条件是否同时满足，任意一个条件不满足则不执行处罚操作；若需满足任意一个条件即判定违规，需拆分多个独立脚本段。
2.封挂脚本核心命令（必备）
封挂脚本核心依赖检测命令和处罚命令，所有命令严格区分大小写，命令结尾需加英文“;”，部分引擎支持扩展命令，基础命令适配所有主流引擎，核心命令分类如下：
（1）异常行为检测命令
此类命令用于检测玩家各类违规行为，是封挂脚本的核心，常用命令及用法如下：
①CheckSpeed>N：检测玩家移动速度，N为正常最大速度值（单位：像素/秒），大于N则判定为加速违规，例如CheckSpeed>150，检测玩家移动速度是否超过150像素/秒。
②CheckAttackSpeed>N：检测玩家攻击速度，N为正常最大攻击速度值，大于N则判定为攻击加速违规，适配所有职业，可根据职业差异设置不同N值。
③CheckSkillSpeed>N：检测玩家技能释放速度，N为正常最大技能速度值，大于N则判定为技能加速违规，常用于检测自动技能脚本。
④CheckMultiLoginN：检测玩家多开账号数量，N为允许多开的最大数量，大于N则判定为多开违规，例如CheckMultiLogin1，禁止玩家多开账号（仅允许单开）。
⑤CheckAutoPick：检测玩家是否开启自动拾取功能，无需设置参数，检测到自动拾取即判定为违规，适用于禁止自动拾取的场景。
⑥CheckAutoFight：检测玩家是否开启自动战斗功能，无需设置参数，检测到自动战斗（自动打怪、自动释放技能）即判定为违规，是最常用的挂机检测命令。
⑦CheckMapStayTime地图IDN：检测玩家在指定地图的停留时间，N为最长允许停留时间（单位：秒），超过N秒且无手动操作则判定为挂机违规，例如CheckMapStayTime5300，检测玩家在地图ID为5的地图停留超过300秒是否违规。
⑧CheckNoOperateN：检测玩家无操作时间，N为最长允许无操作时间（单位：秒），超过N秒则判定为挂机违规，适用于全服全局挂机检测。
⑨CheckItemUseSpeed物品IDN：检测玩家使用指定物品的速度，N为正常最大使用速度（单位：次/秒），大于N则判定为违规，常用于检测自动吃药、自动使用道具的脚本。
（2）处罚执行命令
此类命令用于违规行为判定后，执行具体处罚操作，可根据违规严重程度设置不同处罚，常用命令及用法如下：
①SendMsg颜色代码提示内容：在玩家游戏界面弹出违规提示，颜色代码推荐5（红色）、255（金色），提示内容需清晰明确，例如SendMsg5检测到违规操作，即将进行处罚！;
②MapMove地图ID坐标X坐标Y：将违规玩家传送到指定地图（如禁闭室、安全区），例如MapMove10300300，将违规玩家传送到地图ID为10的禁闭室。
③Take物品ID数量：扣除违规玩家指定道具，作为轻度处罚，例如Take金币100000，扣除违规玩家10万金币。
④ChangeLevelN：修改违规玩家等级，N为目标等级，可用于降级处罚，例如ChangeLevel1，将违规玩家等级降至1级。
⑤BanLoginN：禁止违规玩家登录，N为禁止登录时间（单位：分钟），例如BanLogin120，禁止玩家登录2小时；N=0时，永久禁止登录。
⑥ClearPkPoint：清除违规玩家PK值，适用于违规行为伴随恶意PK的场景，可搭配其他处罚使用。
⑦SendBroad颜色代码公告内容：全服发送违规公告，警示所有玩家，例如SendBroad5玩家XXX因违规挂机，已被处罚，请各位玩家规范游戏行为！;
⑧CloseClient：强制关闭违规玩家游戏客户端，适用于严重违规场景，例如多次违规、使用恶性脚本的玩家。
（3）辅助检测命令
此类命令用于辅助检测，提升封挂脚本的准确性，避免误判，常用命令及用法如下：
①IsOnMap地图ID：检测玩家是否在指定地图内，搭配其他检测命令使用，实现指定地图封挂检测，例如仅检测某副本内的违规行为。
②CheckLevelN：检测玩家等级，N为目标等级，可用于区分等级检测，例如仅检测等级≥50级玩家的违规行为，避免误判新手玩家。
③CheckVipLevelN：检测玩家VIP等级，N为目标VIP等级，可用于设置VIP玩家特殊检测规则（如放宽检测精度）。
④CheckGuild行会名称：检测玩家所属行会，可用于针对特定行会的违规检测，适配行会违规管控场景。
3.编写注意细节
①编码格式：所有封挂脚本文件必须设置为ANSI编码，右键点击脚本文件-打开方式-记事本-文件-另存为，编码选择ANSI，保存覆盖原有文件，否则会出现乱码，导致引擎无法解析脚本。
②命令规范：每行只能编写一条脚本命令，不可多行合并，命令结尾必须加英文“;”，禁止使用中文标点（逗号、句号、问号等），否则会触发语法错误，导致脚本无效。
③命令大小写：所有脚本命令（#IF、#ACT、CheckSpeed、SendMsg等）必须严格区分大小写，不可写为小写（如#if、#act、checkspeed），否则引擎无法识别命令。
④检测精度：设置检测参数（如速度值、停留时间）时，需结合自身游戏设置，参考正常玩家行为数据，避免参数设置过低导致误判，过高导致无法检测到违规行为。
⑤脚本路径：封挂脚本需存放在对应脚本文件夹内，全局封挂脚本存放在Mirserver\Mir200\Envir\MapQuest_def\QManage.txt，指定地图或NPC相关封挂脚本存放在Market_Def或QuestDiary文件夹。
⑥避免冲突：封挂脚本与其他功能脚本（如任务脚本、NPC脚本）需避免变量、命令冲突，自定义变量名称不可用P、D、M、N、S、I、G、A开头，变量使用时需全部大写。
三、传奇封挂脚本实操编写（分场景）
结合游戏常见违规场景，编写可直接复制使用的封挂脚本，涵盖全局挂机检测、加速检测、多开检测、自动拾取检测等核心场景，新手可直接复制粘贴，修改参数即可生效。
1.全服全局挂机检测脚本（最常用）
核心作用：检测全服玩家无操作时间，超过设定时间判定为挂机违规，执行轻度处罚，适用于所有地图，存放在QManage.txt文件中，追加编写即可。
脚本内容：
#IF
CheckNoOperate300//检测玩家无操作时间超过300秒（5分钟），可根据需求修改时间
CheckLevel>10//排除等级≤10级的新手玩家，避免误判
#ACT
SendMsg5检测到您长时间无操作，已判定为挂机违规，将传送至安全区！;
MapMove3330330//传送至地图ID为3的安全区（可修改地图ID和坐标）
Take金币50000//扣除5万金币作为处罚（可修改道具和数量）
BREAK
补充说明：若需加重处罚，可添加BanLogin30（禁止登录30分钟）、ChangeLevel-5（等级降5级）等命令，根据违规严重程度调整。
2.加速行为检测脚本（针对移动、攻击加速）
核心作用：检测玩家移动速度、攻击速度是否超过正常范围，判定为加速违规，执行中度处罚，适用于全服检测，存放在QManage.txt文件中。
脚本内容：
//移动加速检测
#IF
CheckSpeed>150//正常移动速度最大为150像素/秒，可根据自身游戏设置修改
#ACT
SendMsg5检测到您使用加速功能，已违规，将强制传送至禁闭室！;
MapMove10300300//传送至地图ID为10的禁闭室
BanLogin60//禁止登录60分钟
SendBroad5玩家<$USERNAME>因使用加速功能违规，已被处罚，请规范游戏行为！;
BREAK
//攻击加速检测
#IF
CheckAttackSpeed>20//正常攻击速度最大为20，可根据职业差异调整
#ACT
SendMsg5检测到您使用攻击加速，已违规，将扣除对应道具并禁登！;
Take元宝10//扣除10元宝（可替换为其他道具）
BanLogin60
BREAK
3.多开账号检测脚本
核心作用：检测玩家多开账号数量，超过允许数量判定为违规，执行重度处罚，适用于禁止多开的场景，存放在QManage.txt文件中。
脚本内容：
#IF
CheckMultiLogin1//仅允许单开，超过1个账号即判定为违规
#ACT
SendMsg5检测到您多开账号，已违规，将强制关闭所有客户端并禁登！;
CloseClient//强制关闭客户端
BanLogin120//禁止登录120分钟
SendBroad5玩家<$USERNAME>因多开账号违规，已被处罚，严禁多开！;
BREAK
4.自动拾取、自动战斗检测脚本
核心作用：检测玩家是否开启自动拾取、自动战斗功能，判定为挂机违规，执行轻度至中度处罚，适用于副本、打怪地图，可存放在QManage.txt或对应地图脚本中。
脚本内容：
//自动拾取检测
#IF
CheckAutoPick//检测自动拾取功能
IsOnMap5//仅检测地图ID为5的副本（可修改地图ID或删除此句，实现全服检测）
#ACT
SendMsg5检测到您开启自动拾取，已违规，请关闭后继续游戏！;
Take金币30000//扣除3万金币
BREAK
//自动战斗检测
#IF
CheckAutoFight//检测自动战斗功能
CheckMapStayTime5180//检测在地图ID为5的副本停留超过180秒且自动战斗
#ACT
SendMsg5检测到您开启自动战斗挂机，已违规，将传送至安全区并禁登！;
MapMove3330330
BanLogin30
BREAK
5.特定地图封挂脚本（副本、活动地图专用）
核心作用：针对副本、活动等特定地图，设置更严格的封挂规则，检测各类违规行为，执行重度处罚，存放在QManage.txt文件中，绑定指定地图ID即可。
脚本内容：
#IF
IsOnMap8//仅检测地图ID为8的活动地图
CheckNoOperate120//无操作超过120秒（2分钟）判定违规
ORCheckAutoFight//或检测到自动战斗，任意一个条件满足即违规（OR表示或逻辑）
ORCheckSpeed>140//或检测到移动加速
#ACT
SendMsg5活动地图禁止挂机、加速，您已违规，将移出活动地图并扣除奖励！;
MapMove3330330//移出至安全区
Take活动积分100//扣除活动积分（可替换为活动道具）
BanLogin30
BREAK
补充说明：OR逻辑用于多个条件任意一个满足即判定违规，适用于特定地图多违规行为同时检测，可根据需求添加或删除检测条件。
四、封挂脚本存放路径及生效方法
封挂脚本需存放在对应服务端脚本文件夹内，不同类型的封挂脚本存放路径不同，生效方法也略有差异，具体如下，新手可按路径直接存放，避免路径错误导致脚本无效。
1.全局封挂脚本（全服检测）
存放路径：Mirserver\Mir200\Envir\MapQuest_def\QManage.txt
生效方法：打开QManage.txt文件，在文件末尾追加编写封挂脚本，保存文件后，重启M2引擎（M2Server.exe），关闭M2、DBserver、网关，重新启动后即可生效，无需修改其他文件。
注意：QManage.txt是全局触发脚本核心文件，追加封挂脚本时，需避免覆盖原有脚本内容，建议在文件末尾单独划分封挂脚本区域，便于后续修改和维护。
2.特定地图封挂脚本（指定地图检测）
存放路径：Mirserver\Mir200\Envir\MapQuest_def，新建文本文档，命名为“Map_地图ID.txt”（例如Map_5.txt，对应地图ID为5的地图），编写对应地图的封挂脚本。
生效方法：编写完成后保存文件，重启M2引擎，即可实现指定地图的封挂检测，脚本仅对该地图内的玩家生效，不影响其他地图。
3.NPC关联封挂脚本（触发式检测）
存放路径：Mirserver\Mir200\Envir\Market_Def或QuestDiary文件夹，新建文本文档，编写封挂脚本，命名无严格要求（如FengGua.txt）。
生效方法：在NPC.txt文件中添加对应NPC，设置NPC关联该封挂脚本，玩家点击NPC时触发封挂检测，适用于触发式封挂场景（如进入副本前检测），添加NPC后需重启服务端生效。
4.机器人辅助封挂脚本（定时检测）
存放路径：Mirserver\Mir200\Envir\Robot_def，在AutoRunRobot.txt和RobotManage.txt中编写定时检测脚本。
生效方法：在AutoRunRobot.txt中设置定时检测频率（如每10秒检测一次），在RobotManage.txt中编写具体封挂检测逻辑，保存后重启M2引擎，即可实现定时全服封挂检测，提升检测效率。
示例：AutoRunRobot.txt中添加#AutoRunNPCSEC10@FengGuaCheck，RobotManage.txt中编写@FengGuaCheck对应的封挂检测脚本，实现每10秒全服检测一次。
五、封挂脚本常见异常及排查解决
封挂脚本编写或存放错误，会导致脚本无效、误判、服务端报错等问题，核心异常及排查解决方法如下，逐一排查即可快速解决，无需复杂操作。
1.脚本无效，无法检测到违规行为
症状：编写封挂脚本后保存、重启引擎，玩家进行违规操作（如挂机、加速），无任何提示和处罚，服务端控制台无报错，脚本无法生效。
排查解决步骤：
①核对存放路径：确认封挂脚本存放在对应文件夹内，全局脚本存放在QManage.txt，指定地图脚本存放在MapQuest_def文件夹，路径错误会导致引擎无法加载脚本。
②检查脚本格式：核对脚本格式，确保#IF、#ACT、BREAK命令齐全，每行一条命令，命令结尾加英文“;”，无中文标点、无多余空格和空行。
③检查检测参数：确认检测参数（如速度值、无操作时间）设置合理，避免参数过高导致无法检测到违规行为，可适当降低参数测试（如将无操作时间从300秒改为180秒）。
④重启引擎：部分脚本修改后，仅重启M2引擎无效，需关闭M2、DBserver、网关，重新启动整个服务端，确保脚本完全加载。
⑤检查引擎设置：启动M2引擎，点击“功能设置-脚本设置”，确保“启用地图触发脚本”“启用QManage.txt脚本”已勾选，未勾选会导致脚本无法触发。
2.脚本误判，正常玩家被处罚
症状：正常玩家未进行任何违规操作，被封挂脚本判定为违规，弹出提示并执行处罚，影响玩家体验，多为检测参数设置不合理或脚本逻辑错误。
排查解决步骤：
①调整检测参数：适当提高检测参数（如移动速度从150改为160，无操作时间从180秒改为300秒），参考正常玩家行为数据，避免参数过低导致误判。
②添加排除条件：在检测段添加排除条件，如CheckLevel<10（排除新手玩家）、CheckVipLevel3（排除VIP3及以上玩家），减少误判概率。
③检查脚本逻辑：确认脚本中无逻辑错误，如多条件检测时误使用OR逻辑（应使用AND逻辑，多个条件同时满足才判定违规），修改逻辑后重新测试。
④测试验证：在测试服创建测试角色，模拟正常玩家操作（如正常移动、打怪、停留），测试脚本是否误判，调整参数至无误判后，再应用到正式服务端。
3.服务端控制台提示“未知脚本命令”
症状：启动服务端或玩家触发封挂脚本时，控制台弹出“未知脚本命令”提示，脚本无法执行，多为引擎不支持该封挂命令，常见于老旧引擎。
排查解决步骤：
①确认引擎版本：查看M2Server.exe属性，确认引擎类型和版本，老旧引擎（如0328、0538版本）不支持部分封挂命令（如CheckAutoPick、CheckMultiLogin）。
②替换兼容命令：将不支持的命令替换为基础兼容命令，例如用CheckMapStayTime和CheckNoOperate组合，替代CheckAutoFight，实现挂机检测；用其他检测方式替代CheckMultiLogin。
③升级引擎：若使用的是极低版本引擎，建议升级引擎包（推荐1108及以上版本），升级后支持所有封挂基础命令，同时重启服务端，重新添加脚本。
④核对命令拼写：确认所有命令拼写正确，严格区分大小写，例如将CheckSpeed误写为CheckSpead，会导致引擎无法识别，提示未知命令。
4.脚本冲突，导致其他功能脚本失效
症状：添加封挂脚本后，原有功能脚本（如任务脚本、NPC脚本）无法正常执行，服务端控制台无明显报错，多为封挂脚本与其他脚本存在变量、命令冲突。
排查解决步骤：
①定位冲突脚本：关闭所有封挂脚本，逐一启用，重启引擎测试，找到导致冲突的封挂脚本段落。
②修改变量名称：检查冲突脚本中的自定义变量，若与其他脚本重复，修改变量名称（避免用系统自带变量开头），变量使用时全部大写。
③调整脚本顺序：将封挂脚本移至QManage.txt文件末尾，避免与其他全局脚本冲突，或拆分封挂脚本，避免与其他脚本使用相同触发条件。
④简化脚本逻辑：删除封挂脚本中多余的命令，避免复杂逻辑与其他脚本冲突，保留核心检测和处罚命令即可。
5.脚本编码错误，出现乱码
症状：打开封挂脚本文件后，中文提示内容显示乱码，服务端控制台提示“无法识别的字符”，脚本无法执行，或执行后提示内容乱码。
排查解决步骤：
①修改编码格式：右键点击脚本文件，选择“打开方式-记事本”，点击“文件-另存为”，编码选择ANSI，保存覆盖原有文件，关闭记事本后重启服务端。
②重新编写脚本：若修改编码后仍有乱码，删除原有脚本，重新手动输入，避免复制粘贴导致的编码错乱，输入完成后保存，确保编码为ANSI。
③避免使用办公软件编辑：禁止使用Word、WPS等办公软件编辑封挂脚本，此类软件会自动修改编码格式，导致乱码，仅使用记事本编辑。
六、封挂脚本编写进阶技巧（提升检测效果）
基粹挂脚本可满足日常检测需求，若需提升封挂效果，减少漏判、误判，可使用以下进阶技巧，适配更复杂的违规场景，无需额外插件，仅通过脚本优化即可实现。
1.多条件叠加检测：将多个检测命令组合，提高检测准确性，例如CheckAutoFight+CheckMapStayTime+CheckNoOperate，三个条件同时满足才判定为挂机违规，避免误判正常玩家长时间停留。
2.分级处罚机制：根据违规次数、违规严重程度，设置不同处罚力度，例如首次违规扣除金币，二次违规禁登30分钟，三次违规永久禁登，可通过变量记录违规次数，实现分级处罚。
示例：用变量P0记录违规次数，首次违规P0=1，二次违规P0=2，根据P0的值执行不同处罚，脚本如下：
#IF
CheckAutoFight
CheckVarP0=0//首次违规
#ACT
SendMsg5首次违规，扣除5万金币，下次违规将加重处罚！;
Take金币50000
SetVarP01//设置违规次数为1
BREAK
#IF
CheckAutoFight
CheckVarP0=1//二次违规
#ACT
SendMsg5二次违规，禁登30分钟，三次违规将永久禁登！;
BanLogin30
SetVarP02//设置违规次数为2
BREAK
3.定时清理违规记录：通过机器人脚本，每天固定时间清理玩家违规次数变量（如每天0点清理P0变量），避免违规记录长期累积，脚本可在RobotManage.txt中编写。
4.特定职业适配：不同职业的正常速度、技能释放频率不同，可针对职业设置不同检测参数，例如战士攻击速度上限设为22，法师设为18，道士设为20，避免因职业差异导致误判。
5.结合引擎自带封挂功能：主流引擎（如旭玩引擎、GOM引擎）自带基粹挂功能，可开启引擎封挂功能，搭配自定义封挂脚本，实现双重检测，提升封挂效果，引擎封挂功能可在M2引擎“功能设置-封挂设置”中开启。
6.日志记录违规行为：在封挂脚本中添加日志记录命令，记录违规玩家名称、违规时间、违规类型，便于后续查询和管理，例如添加WriteLog封挂日志.txt玩家<$USERNAME>于<$TIME>因挂机违规被处罚；，日志文件会自动生成在服务端指定文件夹。
七、补充说明
1.封挂脚本编写后，需在测试服充分测试，模拟各类违规行为和正常玩家操作，确认无漏判、误判后，再应用到正式服务端，避免影响玩家体验。
2.定期更新封挂脚本，根据玩家违规行为变化，调整检测参数和检测逻辑，例如新增违规行为时，及时添加对应检测命令，提升封挂效果。
3.编写封挂脚本时，建议备份原有脚本文件，避免修改错误导致脚本损坏，同时备份封挂脚本，便于后续恢复和修改。
4.不同引擎的封挂命令略有差异，编写脚本前，可查看对应引擎的帮助文档，确认命令兼容性，避免使用不支持的命令，旭玩引擎、GOM引擎等主流引擎支持所有基粹挂命令。
5.封挂脚本不可过度严格，需平衡封挂效果和玩家体验，避免因检测参数过低、处罚过重，导致正常玩家流失，根据游戏运营需求合理调整。
6.若服务端出现PGStartAutoPickItem1等脚本相关报错，需检查MirServer/Mir2/Config目录下的GameGuard.ini文件，确保配置参数正确，同时检查封挂脚本，修复语法或逻辑错误。