【引擎触发】addbag：物品进包触发的自动绑定

实战应用：用在哪里

addbag 在物品进入背包的瞬间触发：拾取绑定、赃物拦截、稀有品全服通告全在这一个点上做。它还有个前置兄弟 addbagbefore，一前一后构成物品入包的两道关卡，后者甚至能改写物品的绑定属性。

进包触发的绑定

---物品进入背包触发 actor:玩家 item:物品对象
function addbag(actor, item)
    local from = item:GetFrom()
    if from == "monster" then
        setitemstate(item, 2, 1)
        sendmsg(actor, 1, item:GetName() .. " 已绑定")
    end
    if RARE_ITEMS[item:GetName()] then
        QF_Broadcast(actor:GetName() .. " 获得了 " .. item:GetName())
    end
end

触发带 actor 与 item 两个对象：物品来源（GetFrom）决定处理方式，怪物掉落自动绑定、商店购买保持原状、玩家交易维持自由，来源驱动的差异化规则在入口分发。贵重物品的入包通告用稀有品名字典驱动，裁决之杖入包的瞬间全服可见。

前置触发与拦截

---物品进包前触发：可拦截
function addbagbefore(actor, item)
    if BLACKLIST[item:GetName()] then
        sendmsg(actor, 1, "该物品已被回收，无法获取")
        return false
    end
    return true
end

addbagbefore 的返回值是裁决权：返回 false 直接阻止物品进包，被盗装备回收后的全服黑名单拦截在这里生效。前置触发还能改写：活动要求进包的特定物品强制绑定，在前置里调用 SetBind 比入包后再改少一次状态同步。两道触发的分工明确：before 管准许与改写，addbag 管记录与联动。

验证与监控

入包触发的处理耗时监控，单次超过 5 毫秒即告警——这是全服最高频的触发之一，它的耗时就是背包操作的流畅度。

踩坑记录

触发瞬间 item 还未最终入格，业务在触发里读格位信息读到空值，对象级信息（名字、数量、来源）稳定可用而格位相关的要延后处理。黑名单曾经只按物品 ID 匹配，漏掉改版后 ID 变化的老物品，名字与 ID 双索引匹配是加固方案。

上线要点

触发体保持 O(1) 的字典查询，禁止在触发里遍历背包或查询数据库。触发按函数名路由，addbagbefore 与 addbag 的拼写一个字母都不能差，拼错的触发函数不报错但永远不执行——用 gmexecute 打印触发注册表可以验证。

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。