传奇单机QFunction-0脚本使用教程 零基础编写挂载调试大全

传奇单机架设与功能拓展中，QFunction-0是服务端核心全局触发脚本，绝大多数自定义功能、游戏触发机制都依靠该文件实现。多数玩家单机版本功能残缺、自定义脚本无法生效、新增玩法夭折，核心原因就是不熟悉QFunction-0的调用逻辑、挂载方式与编写规则。该脚本属于全局主控脚本，负责处理游戏所有公共触发事件，包含登录触发、打怪触发、拾取触发、死亡触发、对话触发、定时触发等全局逻辑，掌握该脚本的使用方法，即可自主拓展各类单机专属玩法。本文从零讲解文件路径、基础原理、常用触发段、编写规范、挂载生效与排错方法，适配HERO、GOM、LEG、GEE全部主流引擎。
一、QFunction-0脚本核心作用与文件路径
QFunction-0.txt是传奇服务端唯一的全局公共脚本文件，区别于NPC单独脚本、地图独立脚本，该文件无需手动调用，游戏内所有玩家、怪物、场景的行为都会自动扫描该脚本内的指令，执行对应逻辑。所有通用功能，比如上线赠送物品、打怪自动回收、死亡掉落控制、等级奖励、新手buff、拾取提示、全局变量判定，全部依托QFunction-0实现，是单机传奇自定义功能的核心载体。
该脚本固定存放于服务端指定目录，通用路径为 Mirserver\Mir200\Envir\QuestDiary\QFunction-0.txt，部分改版版本路径会简化为 Mirserver\Envir\QFunction-0.txt。文件默认自带基础代码，禁止直接删除或清空，否则会导致多数游戏基础功能失效、自定义脚本全部无法运行。修改、新增功能均在原文件末尾追加代码，不改动系统原生基础代码。
二、QFunction-0基础运行规则
脚本运行遵循固定触发逻辑，每一段功能代码都对应专属触发标签，游戏行为触发对应事件后，引擎自动执行标签内的所有指令。所有代码必须严格遵循引擎脚本语法，换行、空格、标签格式不规范，会直接导致整段脚本失效、引擎报错、游戏功能异常。
文件编码必须保持ANSI格式，使用记事本打开编辑，禁止使用第三方编辑器默认UTF-8编码，编码错乱会造成脚本读取乱码、指令不执行、功能间歇性失效。每次修改保存后，必须在M2引擎重载 quest 脚本，新增功能才会实时生效，无需重启整套服务端。
所有自定义功能代码统一放置在文件末尾，原生系统代码保留不动，避免破坏游戏基础触发逻辑，防止出现登录异常、打怪无掉落、角色数据异常等问题。
三、常用核心触发段与零基础实例代码
QFunction-0的使用核心就是掌握各类触发标签，每类标签对应一种游戏行为，按需添加指令即可实现自定义功能。以下为单机玩家最常用、实用性最高的触发段，附带可直接复制使用的完整实例代码，适配所有单机版本。
1. 玩家上线触发 OnLogin
玩家每次登录游戏自动触发，常用于设置上线奖励、初始属性、新手礼包、全局buff、登录提示等功能，是单机自定义最常用的触发段。
完整可用实例：[@OnLogin] #ACT Give 屠龙刀 1 CHANGEEXP +100000 SENDMSG 6 欢迎进入单机传奇，已赠送新手装备与经验
代码逻辑简单直观，玩家登录瞬间自动执行赠送装备、增加经验、弹出系统提示的操作，可自由替换道具名称、数值与提示文字，实现各类上线初始化功能。
2. 击杀怪物触发 OnKillMon
玩家每击杀一只怪物自动触发，可实现打怪加经验、随机赠送道具、打怪自动回收、击杀提示、专属怪物奖励等自定义玩法，是拓展打宝玩法的核心触发段。
完整可用实例：[@OnKillMon] #ACT RANDOM 1/10 Give 元宝 500 SENDMSG 6 击杀怪物成功，额外获得500元宝
该代码实现击杀怪物百分之十概率掉落元宝，可修改概率数值、道具类型、奖励数量，自定义专属打宝福利机制。
3. 角色死亡触发 OnDie
玩家或怪物死亡时触发，可用于关闭死亡掉落、死亡提示、死亡回城、复活奖励等功能，适配单机休闲游玩需求。
完整可用实例：[@OnDie] #ACT SETDROPPERM 0 SENDMSG 6 死亡保护，本次不会掉落任何物品
代码可直接关闭人物死亡掉落机制，单机游玩无需担心装备掉落，修改简单、功能直观。
4. 等级提升触发 OnLevelUp
玩家升级瞬间自动触发，可设置等级阶梯奖励、属性增幅、解锁地图、解锁技能等进阶功能，丰富角色养成体系。
完整可用实例：[@OnLevelUp] #ACT IF LEVEL=35 THEN Give 祖玛套装 1 SENDMSG 6 等级达标，解锁高阶装备奖励
5. 拾取物品触发 OnPickUpItem
玩家拾取道具瞬间触发，可实现拾取提示、自动叠加道具、拾取回收、数量统计等功能，优化单机打宝体验。
四、脚本编写通用语法规范（避免功能失效）
绝大多数玩家新增脚本无效，都是语法格式错误导致，QFunction-0对格式要求严格，格式出错会直接整段失效且无报错。所有触发标签必须以[@开头、]结尾，标签单独占一行，不可与指令同行。
功能指令必须放置在#ACT下方，所有执行逻辑统一归属触发段内，禁止跨段编写代码。条件判断语句 IF、THEN 必须严格分行，数值、文字参数与指令之间保留空格，杜绝粘连字符。
禁止使用中文符号、全角标点，所有括号、逗号、运算符均使用英文半角符号，中文标点会直接造成引擎无法识别指令，导致脚本瘫痪。每完成一段代码编写，空一行再编写下一段功能，避免代码堆叠错乱。
五、脚本挂载生效正确步骤
编写或修改QFunction-0脚本后，不会自动生效，必须按照固定步骤重载配置，这是自定义功能成功运行的关键。保存修改后的脚本文件，确认编码为ANSI，关闭文档窗口。
打开M2引擎主控制台，点击顶部【重新加载】功能，选择【重新加载任务脚本/QFunction脚本】，等待引擎提示加载完成。无需重启服务端、无需重开网关，重载完成后，新进入游戏的角色即可触发对应功能，已在线角色退出重登即可生效。
批量新增多个功能脚本后，可直接执行全部脚本重载指令，一次性刷新所有自定义逻辑，提升修改效率。
六、脚本失效、功能不触发排查方法
修改QFunction-0后功能无反应，优先排查文件路径，确认修改的是Envir目录下的原版QFunction-0.txt，部分版本存在备用脚本文件，修改备用文件不会产生任何效果。其次检查文件只读属性，取消文件夹只读权限，保证修改内容可以正常保存。
核对脚本编码格式，重新另存为ANSI编码，覆盖原文件。检查代码格式，确认触发标签正确、指令无拼写错误、无中文符号、代码无堆叠错乱。删除文件末尾多余空行、无效乱码字符，避免引擎读取异常。
最后查看M2引擎日志，脚本语法错误会在控制台弹出提示，根据日志提示定位错误行数，修正对应代码即可恢复功能。
七、QFunction-0高阶拓展使用技巧
熟练掌握基础触发段后，可组合多个判断指令，实现复杂单机专属功能。通过IF条件判定等级、职业、地图、道具数量，实现差异化奖励机制；结合全局变量，实现每日单次奖励、累计击杀统计、成长记录等长效功能。
所有单机自定义进阶玩法，包括自动挂机回收、专属BOSS刷新、新手流程优化、属性自定义、地图权限控制、道具合成拓展，全部依托QFunction-0脚本实现。掌握该脚本的编写与挂载逻辑，即可自主完善单机游戏短板，补齐各类缺失功能，完全自定义专属单机传奇版本。