[传奇单机架设] QFunction-0脚本基础使用与触发机制解析

QFunction-0.txt 是传奇单机服务端中极其核心的功能触发脚本文件，通常存放在 D:MirServerMir200EnvirMarket_Def 目录下。这个脚本的主要作用是监听并响应玩家在游戏内的各种行为动作，一旦玩家执行了特定操作，系统就会自动执行该脚本中预设的指令。如果不掌握这个脚本的编写与调用逻辑，很多进阶的自定义功能（如切割、自动回收、特定技能触发等）都无法实现。

QFunction-0 脚本的核心触发机制

触发脚本的运行逻辑是“事件驱动”的。当玩家在游戏中进行物理攻击、魔法攻击、角色死亡、人物升级、甚至跑步等动作时，引擎会捕捉到这些行为，并在 QFunction-0.txt 中寻找对应的标签（以 [@...] 开头的代码段）来执行。

脚本的基本结构通常包含条件判断（#IF）和执行动作（#ACT）。例如，当玩家攻击怪物时，系统会触发“攻击触发”标签，此时可以通过脚本判断攻击目标是否为怪物，进而执行扣除怪物生命值（实现切割功能）或给予特定奖励的指令。

常见触发标签与功能应用

在 QFunction-0.txt 中，不同的标签对应着不同的游戏事件。以下是几个最常用且必须掌握的触发标签：

1. 人物升级触发
当玩家经验值满足条件并提升等级时，会触发该事件。常用于新手引导或等级奖励。
[@Upgrade]
IF
CHECKLEVEL 7
ACT
SENDMSG 6 恭喜您升到7级，已自动为您学习基本剑术！
BREAK

这段代码的意思是：当玩家升级时，检测其等级是否达到7级，如果满足条件，则在屏幕下方发送一条系统提示消息。

2. 角色死亡与击杀触发
包含玩家主动击杀目标（@Kill）和玩家自身死亡（@Die）两种情况。常用于狂暴模式开启、PK惩罚或死亡掉落逻辑。
[@Die]
ACT
SENDMSG 6 您已阵亡，请注意安全！
BREAK

3. 攻击与魔法触发
这是实现自定义战斗机制（如刀刀切割、特定技能附带特殊效果）的关键。
物理/魔法攻击触发：当玩家挥刀或释放魔法时触发。可以通过判断攻击目标的类型（是玩家还是怪物）来执行不同的逻辑。
特定技能触发：格式通常为 [@MagicX]（X代表技能ID）。例如 [@Magic23] 可以在玩家释放ID为23的技能（如爆裂火焰）时触发特定脚本。

4. 自定义用户命令触发
结合 UserCmd.txt 文件，可以在 QFunction-0.txt 中定义玩家通过特定指令触发的功能。
[@UserCmd10]
ACT
SENDMSG 6 您成功触发了自定义命令10！
BREAK

脚本修改后的生效方式

在单机架设环境中，修改完 QFunction-0.txt 脚本并保存后，脚本并不会立刻在游戏中生效。必须通过 M2Server 控制台进行重载操作。

通常的做法是：打开 M2Server 控制台，在“选项”或“功能”菜单中找到“重新加载脚本”或“重新加载QFunction”的选项并点击。部分引擎也支持通过特定的GM命令（如 @重载功能 或 @ReloadQF）在游戏内直接刷新脚本。只有在成功重载后，新添加的触发逻辑才会被引擎读取并执行。

排查脚本错误的方法

如果在编写 QFunction-0.txt 时出现语法错误或逻辑冲突，可能会导致功能失效。可以通过以下方式排查：
检查标签冲突：确保同一个 QFunction-0.txt 文件中，相同的触发标签（如 [@Run]）只出现一次，避免引擎读取混乱。
开启脚本日志：在 M2Server 的参数设置中，勾选“脚本错误日志”功能。当脚本执行出错时，系统会在 Mir200Log 目录下生成日志文件，记录具体的错误行和原因。
核对命令格式：确保使用的脚本命令（如 SENDMSG、GIVE、TAKE 等）拼写正确，且参数格式符合当前引擎的要求。