传奇QFunction-0.txt全版本触发命令大全 行会沙巴克师徒挂机脚本教程
在传奇私服版本制作、脚本修改、功能定制过程中，QFunction-0.txt是核心的功能触发脚本文件，绝大多数游戏事件触发、人物行为反馈、行会功能联动都依托该文件实现。很多版本开发者在调试沙巴克攻防、行会管理、师徒系统、挂机功能时，常找不到对应触发命令，导致功能失效、提示错乱等问题。本文整理2013…
在传奇私服版本制作、脚本修改、功能定制过程中，QFunction-0.txt是核心的功能触发脚本文件，绝大多数游戏事件触发、人物行为反馈、行会功能联动都依托该文件实现。很多版本开发者在调试沙巴克攻防、行会管理、师徒系统、挂机功能时，常找不到对应触发命令，导致功能失效、提示错乱等问题。
本文整理2013年之后官方增补的全部QFunction-0.txt专属触发命令，区分掌门人专属触发、行会全员触发、人物行为触发等场景，附带完整可直接套用的脚本代码，帮助开发者快速调试传奇服务端功能，适配各类引擎版本使用。
一、文件基础说明
本次整理的所有触发命令，均为2013年10月28日后新增，全部归类保存于QFunction-0.txt文件中，专门用于传奇服务端各类自定义功能触发。所有脚本代码无版本兼容冲突，适配主流GOM、LEG、BLUE等传奇引擎，可直接复制粘贴至服务端对应文件中生效。
二、沙巴克专属触发命令（区分掌门人/全员）
沙巴克攻防是传奇核心玩法，触发命令分为掌门人专属触发和行会全员触发两类，开发者可根据版本需求按需选用，避免权限混乱、提示弹窗异常等问题。
2.1 仅行会掌门人专属触发
该组命令仅沙巴克行会掌门（行会老大）可触发，用于掌门人专属提示、权限联动、专属奖励发放等场景。
触发指令说明：
沙巴克丢失触发指令：@LostCastle（仅掌门人生效）
沙巴克占领触发指令：@GetCastle（仅掌门人生效）
完整可运行脚本代码：
;沙巴克丢失仅掌门人（行会老大）触发：@LostCastle
;沙巴克占领仅掌门人（行会老大）触发：@GetCastle
;沙巴克被占领触发
[@GetCastle]
#IF
#Act
#SAY
break
沙巴克被占领!
;沙巴克被别人占领触发
[@LostCastle]
#IF
#Act
SENDMSG 0 提示：沙巴克老大<$USERNAME>要换人了
2.2 行会全体成员通用触发
该组命令针对沙巴克占领/丢失事件，触发对象包含行会所有在线成员（含掌门人），适用于全行会弹窗提示、全员buff增减、公会公告推送等场景。
触发指令说明：
沙巴克丢失全员触发指令：@LostCastleEx
沙巴克占领全员触发指令：@GetCastleEx
完整可运行脚本代码：
;沙巴克丢失全员触发：@LostCastleEx
;沙巴克占领全员触发：@GetCastleEx
[@LostCastleEx]
#ACT
SENDMSG 5 你所在的行会丢失沙巴克
[@GetCastleEx]
#ACT
SENDMSG 5 你所在的行会已占领沙巴克
三、行会全功能触发命令
该章节包含传奇中行会创建、成员加入、成员退出全流程触发命令，其中加入行会触发为2017年04月07日增补功能，支持动态行会名称调用、屏幕居中弹窗提示，适配新版服务端需求。
3.1 创建行会触发
触发指令：@CreateGuild，玩家成功创建行会后自动触发，可自定义创建成功提示、创始人奖励等功能。
;创建行会触发
[@CreateGuild]
#IF
#ACT
break
#SAY
行会已经创建!
3.2 退出行会触发
触发指令：@exitGuild，玩家主动退出行会后触发，可拓展清空行会buff、清除公会标识等联动功能。
;退出行会触发
[@exitGuild]
#IF
#SAY
你已经从行会中退出!
3.3 加入行会触发（2017增补）
触发指令：@JoinGuild，玩家加入任意行会后触发，支持全局聊天提示+屏幕居中双重提示，内置动态行会名称变量。
;20170407增加加入行会触发
[@JoinGuild]
#IF
#Act
SENDMSG 6 你已经加入了<$GUILDNAME>行会！
SendCenterMsg 180 251你已经加入了<$GUILDNAME>行会 0 30
四、师徒系统出师触发命令
传奇师徒系统分为正常出师和强制脱离师徒两种触发模式，区分师傅端、徒弟端独立指令，可分别设置双方的奖励、提示、声望变动等逻辑，所有命令均写入QFunction-0.txt生效。
4.1 常规出师触发
正常完成出师条件后触发，师徒双方独立弹窗提示，可拓展声望奖励、道具发放功能。
;出师触发 QFunction-0.txt
[@UnMasterEnd]
#IF
#ACT
SENDMSG 6 提示：师傅触发！
[@UnMasterEnd1]
#IF
#ACT
SENDMSG 6 提示：徒弟触发！
4.2 强制脱离师徒触发
主动强制解除师徒关系时触发，单独区分师傅和徒弟触发指令，无出师条件限制，适用于强制断交、叛师惩罚等场景。
师傅端强制触发指令：@ForceUnMasterEnd
徒弟端强制触发指令：@ForceUnMasterEnd1
五、挂机功能触发命令
针对传奇内置在线挂机功能，提供开始挂机、停止挂机两个专属触发指令，可用于挂机时长统计、挂机奖励发放、防挂机检测联动等定制开发。
触发指令说明：
开始挂机触发：@StartAutoOnline
停止挂机触发：@StopAutoOnline
完整可运行脚本代码：
;挂机触发 QFunction-0.txt
[@StartAutoOnline]
#IF
#ACT
SENDMSG 6 提示：开始挂机！
[@StopAutoOnline]
#IF
#ACT
SENDMSG 6 提示：停止挂机！
六、脚本使用注意事项
第一，所有命令必须写入服务端QFunction-0.txt文件中，放置于文件任意空白位置，保存后重启服务端即可生效，无需额外配置其他启动项。
第二，沙巴克、行会相关触发命令注意权限区分，掌门人专属指令不要全员复用，避免普通玩家触发管理级权限脚本。
第三，变量标签如<$USERNAME>、<$GUILDNAME>为引擎内置变量，不可手动修改，修改后会导致提示信息读取失败。
第四，2017年增补的加入行会触发命令，老旧引擎若不支持SendCenterMsg居中指令，可删除该行仅保留聊天栏提示即可兼容。
