传奇拾取物品触发提示脚本写法 全屏提示喊话定制教程

传奇拾取提示脚本核心文件定位

实现传奇拾取物品触发提示，需修改服务端核心触发脚本文件，主流GOM、GEE、HERO引擎均依托物品拾取触发段实现，文件路径固定且易查找。常规路径为Mirserver\Mir200\Envir\QFunction-0.txt，该文件负责监听游戏内各类行为触发，拾取物品、使用道具、击杀怪物等操作均会调用此脚本，是编写拾取提示的核心载体。

修改前务必备份原QFunction-0.txt文件，避免代码书写失误导致拾取功能失效、服务端报错。打开文件后找到[@PickUpItem]拾取触发段，无此段则手动新建，所有拾取提示逻辑均写入该段，确保触发时机精准对应物品拾取动作。

基础拾取提示脚本标准代码

基础版拾取提示脚本，支持拾取任意物品触发全屏/个人提示，代码简洁适配全引擎，新手可直接复制使用，仅需微调提示文字和提示样式。代码遵循引擎语法规则，#IF为判定条件，#ACT为执行动作，无复杂参数即可实现基础提示功能。

[@PickUpItem]
#IF
#ACT
SENDMSG 6 【系统提示】<$USERNAME>拾取了<$ITEMNAME>，好运爆棚！
SENDMSG 5 恭喜你成功拾取<$ITEMNAME>，请注意背包空间！
BREAK

代码变量说明：<$USERNAME>为拾取物品的玩家角色名，<$ITEMNAME>为拾取的具体物品名称，无需手动修改，脚本自动调取对应数据；SENDMSG为提示发送指令，后续数字代表提示颜色和显示位置，6为黄色全屏提示，5为红色个人居中提示，可按需更换数字调整样式。

稀有物品专属拾取提示脚本写法

若仅需拾取高阶装备、稀有材料时触发提示，普通物品不提示，可增加物品判定条件，精准筛选目标道具，避免全屏提示过于频繁。通过CHECKITEMNAME指令判定物品名称，或通过ITEMDBID指令判定物品ID，实现稀有物品专属提示。

[@PickUpItem]
#IF
CHECKITEMNAME 屠龙
#ACT
SENDMSG 6 【全服通告】<$USERNAME>在地图爆出并拾取屠龙，实力超群！
BREAK
#IF
CHECKITEMNAME 裁决之杖
#ACT
SENDMSG 6 【全服通告】<$USERNAME>成功拾取裁决之杖，战力飙升！
BREAK
#IF
#ACT
SENDMSG 5 你已拾取<$ITEMNAME>
BREAK

该写法可无限添加判定条目，把屠龙、裁决等稀有物品逐一列入，普通物品仅触发个人小额提示，稀有物品触发全服喊话提示，兼顾实用性和氛围感。也可替换为ITEMDBID指令，用物品数据库ID判定，避免重名物品导致提示错误。

多类型提示样式定制脚本

一、背包满额拾取提示

增加背包空间判定，拾取物品时若背包已满，触发专属提示，引导玩家清理背包，避免物品丢失。搭配CHECKBAGCOUNT指令判定背包剩余格子，实现差异化提示。

[@PickUpItem]
#IF
CHECKBAGCOUNT < 5
#ACT
SENDMSG 5 背包空间不足，拾取<$ITEMNAME>失败，请清理背包！
BREAK
#ELSEACT
SENDMSG 5 你已成功拾取<$ITEMNAME>
BREAK

二、绑定/非绑定物品区分提示

针对绑定物品、非绑定物品设置不同提示文字，清晰区分拾取物品类型，方便玩家管理道具。通过CHECKITEMBIND指令判定物品绑定状态，执行对应提示语句。

[@PickUpItem]
#IF
CHECKITEMBIND
#ACT
SENDMSG 5 你已拾取绑定物品：<$ITEMNAME>
BREAK
#ELSEACT
SENDMSG 5 你已拾取非绑定物品：<$ITEMNAME>
BREAK

脚本写入后不生效的排查方法

一、脚本段名称错误

拾取触发段必须为[@PickUpItem]，字母大小写、符号写错都会导致失效，严格核对字符，无多余空格、错字，确保引擎能识别触发段。文件内不可存在重复的[@PickUpItem]段，重复段会导致逻辑冲突，保留唯一一段即可。

二、语法与符号错误

传奇脚本必须使用英文半角符号，中文全角分号、引号、括号会直接导致脚本报错；#IF、#ACT、#ELSEACT需顶格书写，不可缩进空格；提示文字不可换行，变量名书写无误，避免漏写<>、$符号。

三、引擎未加载脚本

修改保存脚本后，需重启服务端M2引擎，或在M2控制台点击“重新加载触发脚本”，让引擎读取新脚本内容。未重启引擎会继续沿用旧代码，提示功能无法生效。

四、文件编码格式错误

QFunction-0.txt文件必须为ANSI编码，用记事本打开后另存为，编码选择ANSI覆盖原文件，UTF-8编码会导致文字乱码、脚本失效，这是新手常见失误点。

不同引擎脚本适配调整

GEE引擎需在M2设置中开启“物品拾取触发”开关，否则[@PickUpItem]段不执行；HERO老引擎提示指令为SENDMSGMSG，可替换为SENDMSG兼容；GOM引擎支持更多自定义变量，可添加<$MAPNAME>地图名、<$USERLEVEL>玩家等级变量，丰富提示内容。

多版本传奇服务端适配时，无需改动核心逻辑，仅调整指令名称和提示样式即可，核心拾取触发段逻辑通用，仅引擎细节参数略有差异。

拾取提示脚本测试步骤

1. 保存脚本文件，重启服务端引擎，确保脚本加载完成

2. 登录游戏创建测试账号，前往野外击杀怪物掉落物品

3. 手动拾取物品，查看是否弹出对应提示文字，核对角色名、物品名是否正确

4. 测试稀有物品拾取，查看全服提示是否正常触发，普通物品提示是否简洁

5. 清空背包测试拾取，再填满背包测试失败提示，验证判定逻辑是否正常

脚本常见问题修复

提示文字乱码：重新将脚本文件保存为ANSI编码，删除特殊符号、表情字符，仅保留纯文字和变量。

拾取无任何提示：检查触发段名称、语法格式，重启引擎，确认服务端未禁用拾取触发功能。

全服提示刷屏：删减普通物品提示，仅保留稀有物品判定，降低提示触发频率。

物品名显示错误：核对物品名称拼写，改用ITEMDBID用数据库ID判定，规避名称误差。