【后端接口】setdura：装备持久度的修改与修理联动

实战应用：用在哪里

持久度是装备的消耗属性：战斗掉持久、修理回持久、持久归零装备失效。setdura 接口负责持久度的精确修改，配合耐久上限的读取，修理费用的计算、持久归零的提示全在这条链路上。

接口签名与修改

---修改物品持久度 actor:玩家 itemmakeid:物品唯一ID char:加减符 dura:持久值
function setdura(actor, itemmakeid, char, dura) end

-- 战斗掉持久：每次死亡随机掉 2 到 5 点
local drop = math.random(2, 5)
setdura(actor, weaponMakeId, "-", drop)

itemmakeid 是物品的唯一 ID（每件装备实例独立），char 用加减符号指定方向，dura 是本次修改的量。持久度的当前值与上限通过物品对象的字段读取，掉持久前先判断剩余量，归零的边界提前一步处理。

修理与归零

-- 修理铺：按缺口计算费用
function Repair.calc(actor, makeId)
    local cur, max = itemdura(actor, makeId)
    local gap = max - cur
    if gap <= 0 then return false, "无需修理" end
    local fee = gap * 150
    if not actor:TakeGold(fee) then return false, "金币不足" end
    setdura(actor, makeId, "+", gap)
    return true
end

修理费按持久缺口每点 150 金币计算，itemdura 读取当前与上限。持久归零的装备攻击力按三成结算（不直接失效），这是传奇式的温柔：装备残血可用但菜。特殊修理（可恢复最大持久）走稀有材料，普通修理只回当前值，两条修理线的定价差了十倍。

验证与监控

持久度的总消耗与修理恢复量的每日对账，武器磨损曲线的数据是修理定价调整的依据。

踩坑记录

setdura 的 makeid 传错曾把 A 玩家的修理加到了 B 玩家的装备上，唯一 ID 的获取必须来自物品对象本身而不是界面缓存。持久归零三成攻击的规则文档滞后，玩家以为装备废了直接卖店，规则说明补进装备 tooltip 后误卖归零。

上线要点

持久度变更与金钱消耗的流水成对记录，修理收入是经济系统的重要回收口。掉持久的事件来源分类（死亡、战斗、挖矿）统计，不同来源的损耗率支持差异化的磨损曲线。

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