传奇限时道具Item表配置及到期QF触发脚本教程
在传奇版本开发、服务器定制及道具规则调试过程中，限时道具的时长计算规则配置、到期弹窗触发脚本是核心基础功能。很多GM在架设版本时，常出现限时道具计时异常、到期无提示、英雄装备计时错乱等问题，核心原因是Item表字段配置不规范、QF触发脚本挂载错误。本文详细讲解传奇限时道具Item表字段配置规范、四种…
在传奇版本开发、服务器定制及道具规则调试过程中，限时道具的时长计算规则配置、到期弹窗触发脚本是核心基础功能。很多GM在架设版本时，常出现限时道具计时异常、到期无提示、英雄装备计时错乱等问题，核心原因是Item表字段配置不规范、QF触发脚本挂载错误。本文详细讲解传奇限时道具Item表字段配置规范、四种核心计时规则用法，以及人物/英雄限时物品到期QF触发脚本完整代码，可直接复制用于版本修改与功能部署。
一、传奇限时道具Item表核心配置说明
传奇数据库Item表为限时道具提供专属判定字段，通过Need字段绑定计时规则，NeedLevel字段设置具体限时时长（单位：分钟）。不同Need数值对应差异化的计时逻辑，精准适配穿戴计时、全域计时、离线累计等各类道具需求，是限时道具功能生效的核心底层配置。
1.1 四大标准计时规则详细配置
以下为Item表完整配置规则，所有字段直接写入数据库即可生效，计时逻辑区分穿戴状态、存储位置、在线离线场景，适配装备、消耗品、专属道具等不同物品类型。
配置规则1：Need=101（仅穿戴状态计时）
关联字段：Need=101，NeedLevel=限时时长（分钟）
计时判定逻辑：道具仅穿戴在人物身上时累计计时，道具放入背包、仓库、摆摊上架、拍卖行寄售等所有非穿戴状态，均停止计时。该规则最适合限时专属装备、穿戴类时装、部位特效道具。
配置规则2：Need=102（穿戴及库存全场景计时）
关联字段：Need=102，NeedLevel=限时时长（分钟）
计时判定逻辑：道具穿戴中、穿戴后脱下存入背包/仓库，全程累计计时；仅摆摊展示、拍卖行寄售、交易挂单等对外公示状态不计算时间。该规则常用于限时稀有材料、可交易限时装备，避免玩家通过存仓库卡时长。
配置规则3：Need=103（获取即计时，离线暂停）
关联字段：Need=103，NeedLevel=限时时长（分钟）
计时判定逻辑：玩家获取道具瞬间立即启动计时，人物在线期间无论道具处于穿戴、背包、仓库任意状态均持续计时；角色离线后自动暂停计时，上线后恢复累计。适合限时礼盒、时效buff道具、日常限时任务物品。
配置规则4：Need=104（获取即计时，离线累计）
关联字段：Need=104，NeedLevel=限时时长（分钟）
计时判定逻辑：道具获取即刻启动计时，不受角色在线、离线状态影响，全天候累计时长，与道具存放位置无关联。该规则为硬时效道具专用，适合限时充值道具、周期活动道具、过期清零类材料。
二、限时物品到期QF触发脚本（人物端）
完成Item表数据库配置后，需要在QF脚本中挂载到期触发检测脚本，实现道具到期后自动弹窗提示玩家。以下为官方标准脚本代码，无冗余指令，直接复制至版本QF文件即可生效，支持读取到期道具名称并精准推送提示。
[@ItemExpired]
#Act
Sendmsg 7 你到期的装备为<$ExpiredItemName>
脚本解析：该脚本为人物限时物品到期专属触发标签，Sendmsg 7为客户端顶部居中弹窗提示级别，<$ExpiredItemName>为系统内置变量，可自动读取已到期的道具名称，无需手动修改道具编码，适配所有配置上述计时规则的物品。
三、英雄限时物品到期QF触发脚本（副将端）
传奇英雄（副将）的限时装备计时、到期提示为独立触发通道，不可与人物端脚本混用。单独配置下方QF脚本，可实现英雄限时道具到期后，向主号推送专属提示，避免英雄装备过期失效玩家无感知的问题。
[@HeroItemExpired]
#Act
Sendmsg 3 你的英雄到期的装备为 <$H.ExpiredItemName>
脚本解析：[@HeroItemExpired]为英雄物品到期专属触发入口，Sendmsg 3为侧边信息栏提示级别，不遮挡核心游戏界面；内置变量<$H.ExpiredItemName>精准读取英雄身上到期的装备名称，适配英雄专属限时装备、副将时效首饰等道具。
四、版本部署常见问题排查要点
1、计时不生效：检查Item表Need字段数值是否准确录入，NeedLevel是否设置为纯数字（分钟），禁止输入汉字或符号；
2、到期无提示：确认两个QF触发脚本已完整写入Quest脚本文件，标签名无大小写修改，变量符号无遗漏；
3、离线计时异常：核对道具绑定的Need数值，103为离线暂停、104为离线累计，按需调整数据库配置即可修复。
