一、核心组队脚本命令及基础用法
传奇服脚本组队命令分两类：玩家触发指令与脚本控制指令，核心命令适配多数客户端，可实现主动邀请、强制组队、解散队伍等功能。基础邀请组队命令为TEAMINVITE $USERNAME 目标玩家名，脚本中调用该指令可让当前玩家向指定目标发送组队邀请，需替换“目标玩家名”为具体角色名，或用变量指代。
强制组队命令FORCEJOINTEAM 队长名 队员名，无需队员同意即可将其加入队长队伍，仅适用于管理员脚本或指定NPC权限，普通玩家脚本无法调用。解散队伍命令TEAMDISBAND，仅队长可触发，脚本中需搭配权限判断，确保仅队长执行该指令。
组队状态校验命令CHECKTEAM，用于判断玩家是否处于组队状态，语法为CHECKTEAM 0（未组队）、CHECKTEAM 1（已组队）、CHECKTEAM 2（作为队长组队），常作为前置判断添加至脚本逻辑中。
二、NPC组队指令及完整脚本示例
NPC实现组队功能需绑定自定义触发节点，核心指令为上述组队命令，搭配校验逻辑形成完整流程。以下为两种高频NPC组队脚本示例，可直接适配多数服务器。
示例一：NPC主动为玩家匹配组队（随机匹配同地图未组队玩家）
[@NPC组队匹配]#IF CHECKTEAM 0（判断当前玩家未组队） ISONMAP 001（限定地图，可替换） #ACT SEARCHPLAYER 001 0（搜索目标地图未组队玩家） TEAMINVITE $USERNAME $SEARCHRESULT（向搜索到的玩家发送邀请） SENDMSG 6 已为你向玩家[$SEARCHRESULT]发送组队邀请！ #ELSEACT SENDMSG 6 你已处于组队状态，无法发起匹配！
示例二：NPC强制组建固定队伍（管理员场景使用）
[@NPC强制组队]#IF CHECKADMIN 1（校验管理员权限） #ACT FORCEJOINTEAM 玩家A 玩家B FORCEJOINTEAM 玩家A 玩家C SENDMSG 6 已将玩家B、C加入玩家A队伍，队伍组建完成！ SendCenterMsg 146 252 管理员已通过NPC组建固定队伍！ 1 #ELSEACT SENDMSG 6 无权限执行该操作！
三、组队脚本关键校验逻辑补充
脚本组队需添加多重校验，避免指令执行异常。首先添加队伍人数校验，命令为CHECKTEAMMEMBERCOUNT 数量，语法为CHECKTEAMMEMBERCOUNT < 5（判断队伍人数少于5人），防止队伍人数满员时重复邀请。
其次添加目标状态校验，通过CHECKONLINE 目标玩家名判断目标是否在线，离线状态下拦截组队邀请，避免指令失效。同时搭配CHECKENEMY $USERNAME 目标玩家名，防止向敌对玩家发送组队邀请。
示例校验逻辑整合：#IF CHECKTEAM 0 CHECKONLINE 玩家B CHECKTEAMMEMBERCOUNT < 5 #ACT TEAMINVITE $USERNAME 玩家B，三重校验确保邀请有效。
四、组队脚本适配及指令兼容问题
部分老旧客户端不支持TEAMINVITE等通用命令，需替换为变量模拟组队流程。绑定玩家组队标记，格式为SET [200] 玩家A_玩家B，通过标记判断组队关系，再搭配坐标同步指令实现组队效果，替代原生组队命令。
多线路服务器需添加线路校验，指令为CHECKLINE 线路号，确保组队双方处于同一线路，避免跨线路组队失效。脚本中添加#IF CHECKLINE $LINE（当前线路），确保邀请目标与玩家同线路后再执行指令。
记忆套装组队传送指令为特殊场景用法，队长佩戴记忆套装后，脚本可调用TEAMTRANSPORT（天地合一），前提是队员开启允许传送权限，指令格式为#ACT SENDMSG 6 队长已触发天地合一！ TEAMTRANSPORT，仅适配支持记忆套装属性的服务器。
五、NPC组队脚本常见异常及排查
组队邀请发送成功但无响应，多为客户端指令拦截，需检查服务器配置文件，确认开启脚本组队权限，同时排查目标玩家是否关闭“自动接收组队邀请”功能，可在脚本中添加提示，引导玩家开启权限。
强制组队指令失效，需核对NPC权限是否充足，在服务器权限配置文件中为NPC添加“FORCEJOIN”权限，无需提升至最高权限，仅开放组队相关权限即可。
脚本执行后队伍状态错乱，多为校验逻辑缺失，需补充TEAMCLEAR（清除无效组队标记）指令，在组队前清理玩家残留组队状态，避免重复绑定组队关系。
六、组队脚本进阶功能扩展
可在组队成功后添加属性加成，通过CHANGEATK + 10（增加攻击）、CHANGEMAXHP + 200（增加生命值）指令，为队伍成员附加临时增益，提升组队吸引力，脚本逻辑为#ACT TEAMINVITE $USERNAME 玩家B CHANGEATK + 10（仅当前玩家生效，需循环为队员添加）。
添加组队解散触发事件，通过@OnTeamDisband节点，在队伍解散时清除增益属性，语法为[@OnTeamDisband]#ACT CHANGEATK -10，确保属性加成与组队状态同步。
多NPC联动组队，通过共享变量传递组队信息，例如NPC1记录玩家组队需求，NPC2读取变量匹配队友，实现跨NPC组队功能，核心为变量的写入与读取同步。
