传奇行会QF脚本全解析 行会触发命令与行会战参数教程
在传奇服务端定制开发中，行会系统是玩家社交、团战、阵营对抗的核心模块，而QFunction-0.txt行会触发脚本是控制行会行为逻辑、权限限制、消息提示的核心文件。掌握各类传奇行会触发标签、内置命令及系统变量的用法，能够帮助GM快速定制入会、退会、封号编辑、行会战等专属功能，优化服务器玩法体验。本文…
在传奇服务端定制开发中，行会系统是玩家社交、团战、阵营对抗的核心模块，而QFunction-0.txt行会触发脚本是控制行会行为逻辑、权限限制、消息提示的核心文件。掌握各类传奇行会触发标签、内置命令及系统变量的用法，能够帮助GM快速定制入会、退会、封号编辑、行会战等专属功能，优化服务器玩法体验。本文全面梳理主流传奇行会QF触发脚本、行会战宣战命令及内置变量，适配单机、开区版本的脚本修改需求。
一、核心文件说明：QFunction-0.txt行会脚本
QFunction-0.txt是传奇服务端核心功能触发脚本文件，所有行会相关的前置触发、后置触发、权限拦截、消息推送逻辑，均在此文件中配置。所有行会脚本无需额外引入外部文件，直接写入该文档即可生效，适配主流传奇引擎。
脚本注释规范：文档中;为单行注释、//为功能备注，仅用于开发者查看，服务器运行时不会执行注释内容。
二、全流程行会触发脚本详解
2.1 入会相关触发脚本
2.1.1 加入行会前置触发
该触发标签在玩家提交入会申请、掌门确认前执行，可用于拦截入会行为、推送前置提示信息，附带预入会行会名、成员人数两大传递参数。
;加入行会前的QF触发
[@ConfirmGuildAddMember]
#IF
#ACT
;ConfirmGuildAddMember (1=禁止 0=允许)
;Stop (禁止加入行会),兼容2个禁止加入行会命令
;增加传递参数，预加入行会名<$Param1>和预加入行会成员人数<$Param2>
SENDMSG 6 <$USERNAME>：即将加入【<$Param1>】，拥有【<$Param2>】小伙伴！
2.1.2 加入行会成功后置触发
玩家成功加入行会瞬间触发，可推送入会成功提示、记录入会日志、触发入会奖励等衍生逻辑，调用当前行会名称、实时人数变量。
//加入行会后触发例子
[@GuildAddMember]
#IF
#ACT
SENDMSG 6 <$USERNAME>：已加入【<$GUILDNAME>】，拥有【<$GUILDMEMBERCNT>】小伙伴！
2.1.3 掌门审批入会申请触发
掌门在招募页面点击接受玩家入会申请时专属触发，可判断申请人在线状态，拦截指定玩家入会，附带玩家在线状态、唯一UID、角色名三大参数。
//掌门招募逐一触发(招募页面点击接受)
[@CanAddJoinMember]
#IF
EQUAL <$param1> 1
#ACT
Stop
SENDMSG 6 接受玩家<$param3>入会申请，是否在线<$param1>--USERID=<$param2>
;<$param1> 0~1 0表示该玩家不在线，1表示该玩家在线
;<$param2> 玩家唯一UID
;<$param3> 被接受的玩家名
2.1.4 创建行会前置触发
玩家申请创建行会时触发，常用于限制特定玩家、充值档位、等级账号创建行会，自定义禁止创建原因提示。
//创建行会前触发
[@CheckBuildGuild]
#IF
#ACT
SENDMSG 7 禁止<$USERNAME>创建行会：<$param1>
Stop
2.2 退会与解散行会触发脚本
2.2.1 退出行会执行触发
玩家确认退会成功后触发，可设置玩家退会后属性变量、推送全服提示、清空行会专属buff，脚本中U30为自定义全局变量。
//退出行会触发
[@GuildDelMember]
#IF
#ACT
MOV U30 120
SENDMSG 7 <$USERNAME>退出行会
2.2.2 退出行会前置拦截触发
玩家点击退会按钮、未确认前触发，添加Stop命令可直接拦截退会行为，适用于锁定行会成员、团战禁止退会等场景。
//退出行会前触发
[@GuildDelMemberBefore]
#IF
#ACT
STOP
2.2.3 解散行会前置拦截触发
行会掌门提交解散申请时触发，通过Stop命令禁止解散操作，保护顶级行会、公会阵营不被误解散。
//解散行会前
[@GuildCloseBefore]
#IF
#ACT
STOP
//解散行会（后置触发预留）
[@GuildClose]
2.3 行会管理权限触发脚本
2.3.1 行会公告编辑触发
掌门或权限成员修改行会公告时触发，可记录编辑日志、过滤违规公告文字，推送编辑成功提示。
//编辑行会公告前触发
[@UpdateGuildNotice]
#IF
#ACT
SENDMSG 6 你编辑了 行会公告
2.3.2 成员踢出拦截触发
掌门发起踢人操作时触发，添加拦截命令后禁止踢出任意成员，适用于固定成员配置的专属行会版本。
;//掌门踢出行会成员前触发
[@GuildChiefDelMember]
#IF
#act
stop
sendmsg 7 禁止踢出行会
2.3.3 行会封号编辑权限触发
传奇引擎支持1-5级自定义行会封号，该系列触发可单独锁定指定等级封号的编辑权限，禁止修改掌门等核心职位名称。
//行会编辑封号前触发 QF触发@SetRankNameXX（XX：1-5个行会封号）
[@SetRankName1]
#act
stop
sendmsg 6 不允许编辑行会掌门封号！
2.3.4 行会职位任命前置触发
针对掌门、副掌门、普通成员等5级职位，任命操作执行前触发，可拦截违规任命、添加任命权限校验。
[@SetGuildRank1]
#IF
#act
Sendmsg 6 任命掌门人前触发
Stop
[@SetGuildRank2]
#IF
#act
sendmsg 6 任命副掌门前触发
Stop
[@SetGuildRank3]
#IF
#act
sendmsg 6 任命成员3前触发
Stop
[@SetGuildRank4]
#IF
#act
sendmsg 6 任命成员4前触发
Stop
[@SetGuildRank5]
#IF
#act
sendmsg 6 任命成员5前触发
Stop
三、行会战宣战命令使用教程
行会战是传奇行会对抗的核心玩法，通过QF脚本内置SETGUILDWAR命令可实现自定义行会宣战，支持自定义对战双方、战斗时长，广泛用于定时团战、阵营赛事玩法。
3.1 命令语法与参数说明
命令格式：SETGUILDWAR 参数1 参数2 参数3
参数1：宣战行会名称（发起方）；参数2：敌对行会名称（接收方）；参数3：对战时长（单位：分钟）
3.2 脚本调用示例
可绑定NPC对话、定时脚本、管理员命令，一键触发指定行会对战，示例如下：
[@设置行会宣战]
#ACT
SETGUILDWAR 红方 蓝方 30
上述脚本执行后，红方行会将向蓝方行会发起宣战，行会战持续30分钟，期间双方成员可无惩罚PK、激活行会对战buff。
四、传奇行会系统内置常量变量
QF脚本中调用内置变量，可自动读取服务器、行会实时数据，无需手动赋值，是精简脚本、提升兼容性的关键，常用核心变量如下：
变量名称 | 变量功能说明 |
<$GUILDNAMENOTICE> | 行会公告常量，读取当前行会已发布的公告内容 |
<$RANKNAME> | 行会职位名称，调用玩家当前所在行会的封号名称 |
<$GUILDNAME> | 行会名称，读取玩家所属行会的完整名称 |
<$GUILDMEMBERCNT> | 当前行会人数常量，实时统计行会在线+离线总成员数 |
五、脚本使用常见注意事项
第一，所有行会触发标签必须写入QFunction-0.txt文件，放置在对应功能分区内，避免脚本重叠失效；第二，Stop命令为强制拦截指令，用于禁止入会、退会、解散、任命等操作，无需额外添加判断语句即可生效；第三，参数区分大小写，行会名称、角色名在脚本中需与游戏内名称完全一致，避免行会战、入会触发失效；第四，多版本引擎通用，本文所有脚本适配主流传奇引擎，开区、单机版本可直接复制使用。
