传奇行会战宣战命令教程 SETGUILDWAR脚本参数详解

一、传奇行会战宣战命令核心介绍

在传奇版本架设、服务端脚本编辑过程中，行会战是玩家行会对抗的核心玩法，而行会战宣战命令是触发行会攻防对战的核心脚本指令。主流传奇服务端均采用SETGUILDWAR作为专属宣战指令，通过配置对应参数，即可实现自定义行会敌对、设置对战时长，精准控制行会战开启规则，是GM调整行会玩法、配置活动脚本的常用核心命令。

二、SETGUILDWAR指令语法格式

标准脚本语法结构，可直接复制用于传奇服务端NPC、功能脚本编辑：

SETGUILDWAR 参数1 参数2 参数3

三、指令参数详细解析

该指令包含三个必填参数，参数顺序不可调换，缺失任意参数会导致脚本执行失效：

3.1 参数1：宣战行会名字

发起行会战的主动方行会全称，必须与游戏内行会名称完全一致，区分大小写、特殊符号，名称错误将无法正常发起宣战。

3.2 参数2：敌对行会名字

被发起宣战的被动方行会全称，同样需严格匹配游戏内已创建的行会名称，无此行会时指令不生效。

3.3 参数3：时间分钟

行会战的有效持续时间，单位为分钟。数值支持自定义设置，根据服内玩法需求调整时长即可。

四、完整可直接使用的脚本示例

以下为成型触发脚本，可直接写入传奇服务端NPC脚本中，点击对应功能即可完成行会宣战：

[@设置行会宣战]

#ACT

SETGUILDWAR 红方 蓝方 30

脚本释义：玩家触发【设置行会宣战】功能后，系统将立即让【红方】行会向【蓝方】行会发起宣战，本次行会战持续时长为30分钟，时间结束后敌对状态自动解除。

五、脚本使用注意要点

1、所有行会名称必须与游戏内数据库名称完全一致，禁止使用简称、错别字，避免宣战失败；

2、时间参数仅支持正整数，输入0或负数会导致指令异常，建议常规设置区间为10-120分钟；

3、该指令仅作用于已创建的正式行会，未注册行会、解散行会无法触发对战规则；

4、部分定制版传奇服务端需开启行会对战权限后，该指令才能正常执行。