传奇QF脚本教程：NPC商店买卖物品触发指令详解
详解传奇QF脚本引擎专属NPC商店买卖触发脚本，提供完整可直接套用代码，说明触发机制、参数含义及安装方法，适配盟重药店等系统商店，助力传奇版本开发与交易调试。…
一、脚本功能概述
本文分享传奇服务端QF专属NPC商店物品买卖触发脚本，该脚本针对盟重药店等系统原生NPC商店生效，可精准捕捉玩家购买、售卖物品行为，同步推送物品名称、ID、交易价格等日志提示，是传奇版本开发、NPC功能定制、交易数据调试的常用基础脚本。
需要重点区分：此脚本仅适配系统原生NPC商店，不支持游戏内置商城、玩家摆摊交易场景，规避版本调试中触发无效的问题。
二、脚本触发机制说明
该脚本依托QF引擎客户端交易专属标签触发，包含两大核心触发入口，精准对应玩家两类操作行为：
1. 玩家在NPC商店购买物品：触发[@ClientBuyItem]客户端购买标签
2. 玩家在NPC商店售卖物品：触发[@ClientSellItem]客户端售卖标签
触发后通过SENDMSG系统弹窗指令，向玩家客户端推送实时交易明细，方便GM快速核对交易参数、排查物品异常流转问题。
三、完整可直接使用QF脚本代码
;========== 传奇系统NPC商店交易触发脚本 ==========
;触发引擎：QF引擎
;适用场景：盟重药店、土城杂货铺等系统原生NPC商店
;排除场景：游戏商城、玩家个人摆摊交易
[@ClientBuyItem]
#if
#ACT
;客户端弹窗提示：玩家成功购买商店物品
sendmsg 7 购买了NPC商店物品
;输出购买物品全参数：名称/索引ID/唯一ID/购买价格
SENDMSG 7 买入物品名字--<$Param1> 物品IDX--<$Param2> 物品唯一ID--<$Param3> 买入价格--<$Param4>
[@ClientSellItem]
#IF
#ACT
;输出售卖物品全参数：名称/索引ID/唯一ID/售卖价格
SENDMSG 7 卖出物品名字--<$Param1> 物品IDX--<$Param2> 物品唯一ID--<$Param3> 卖出价格--<$Param4>
四、脚本参数释义
脚本中内置4个通用参数，为QF引擎原生内置变量，无需额外定义，参数含义统一如下：
$Param1：交易物品名称，精准显示玩家买卖的道具全称
$Param2：物品IDX，服务端物品数据库内的索引编号
$Param3：物品唯一ID，单件道具的独立识别编码，区分同名称不同道具
$Param4：交易价格，本次买入/卖出的实际金币数额
五、脚本安装与使用注意事项
1. 安装路径：将代码复制至服务端Mir200\Envir\Market_Def文件夹内的QF文本脚本中，保存后重启引擎即可生效。
2. 场景限制：仅对官方原生功能NPC生效，自定义新增NPC商店需绑定对应客户端触发标签。
3. 提示层级：脚本使用sendmsg 7全局弹窗模式，所有在线玩家可见，如需仅自身可见可修改消息层级参数。
4. 版本适配：兼容996引擎全系版本，无版本兼容报错问题，零基础GM可直接套用。
