跳转至

副本相关命令速查表

本页按“常用 + 易错”的角度整理副本相关命令，方便快速查阅与脚本落地。

✅ 检测命令速查

Groupleader / GroupLeader / 检测队长

语法：

#IF
Groupleader

语义：玩家是队长则成立；无队伍/非队长不成立。

GroupCheckNearby

语法：

#IF
GroupCheckNearby

语义：以当前对话 NPC 为中心，检查 9 格内且同地图；离线成员直接失败。

CheckGroupVar（全员满足）

语法：

#IF
CheckGroupVar 变量 比较符 值

语义：要求所有成员满足条件；任意成员不满足或变量解析失败 → 不成立。

常用写法：

; 队伍所有成员等级 >= 25
#IF
CheckGroupVar $LEVEL >= 25

CheckGroupVarAny（有人满足）

语法：

#IF
CheckGroupVarAny 变量 比较符 值

语义：只要有人满足即可；成员变量解析失败会被跳过。

CheckGroupVarEx（附加条件过滤）

语法：

#IF
CheckGroupVarEx 主变量 主比较符 主值 附加变量 附加比较符 附加值

语义：先筛选“附加条件满足”的成员，再对其检测主条件；只要有人满足即成立。

示例：

; 排除 J47 == 1 的成员，只检测其余人金币
#IF
CheckGroupVarEx $GOLD < 100000 J47 == 0

CheckGroupMemberGold（全员金币检测）

语法：

#IF
CheckGroupMemberGold 操作符 金额

语义：所有成员金币都满足才成立。

常用阻止写法：

#IF
not CheckGroupMemberGold >= 50000
#ACT
Break
#SAY
队伍有成员金币不到5万！

✅ 动作命令速查

CreateInstance（创建副本）

语法：

CreateInstance 地图编号 持续时间 脚本开关 脚本参数 难度参数

说明：

  • 最少 4 个参数：地图编号 持续时间 脚本开关 脚本参数
  • 难度参数可省略，默认 0
  • 难度参数 > 30000 时，创建后直接传送创建者

InstanceMove（个人传送）

InstanceMove 地图编号 X坐标 Y坐标 区域类型

GroupInstanceMove（组队传送）

GroupInstanceMove 地图编号 X坐标 Y坐标 区域类型

说明：仅传送在线成员，需先确保已创建副本且队伍存在。

GroupGoto（队伍跳转标签）

GroupGoto @标签

说明：常用于“先传送，再统一扣道具/金币”。

✅ 经典流程模板

组队副本入口（含扣费）

[@入口]
#IF
not Groupleader
#ACT
Break
#SAY
勇士你不是队长，请等待队长操作！

#IF
not CheckGroupMemberGold >= 100000
#ACT
Break
#SAY
队伍有成员金币不到10万！

#IF
GroupCheckNearby
#ACT
CreateInstance 80 120 0 0 0
GroupInstanceMove 80 0 0 3
GroupGoto @扣金币
Break
#ELSESAY
队伍成员不在附近

[@扣金币]
#IF
#ACT
TakeGold 100000

常见易错点

  • CheckGroupVar 是“全员满足”，不是“有人满足”
  • CheckGroupVarAny 才是“有人满足”
  • GroupCheckNearby 以 NPC 为中心，不是以玩家为中心
  • GroupInstanceMove 只传送在线成员

相关文档