【框架设计】物品合成：配方校验与材料预锁定

实战应用：用在哪里

合成把低阶材料凑成高阶道具，是传奇引擎材料体系的关键枢纽：三块黑铁合成一块精炼黑铁，五个碎片合成整装。并发场景下两名操作可能同时消耗同一组材料，预锁定机制保证一次合成独占材料，杜绝超扣导致的负数库存。

配方与预锁定

function Craft.check(plr, recipeId)
    local recipe = RECIPES[recipeId]
    for _, need in ipairs(recipe.cost) do
        if QF_CountItem(plr, need.id) < need.n then
            return false, need.id .. " 数量不足"
        end
    end
    return true
end

function Craft.lock(plr, recipeId)
    local recipe = RECIPES[recipeId]
    for _, need in ipairs(recipe.cost) do
        QF_LockItem(plr, need.id, need.n)
    end
    plr.craftLock = recipeId
end

校验与锁定分两步，锁定后材料进入冻结态，背包界面对应格子置灰，玩家看得见材料已被占用。锁定状态 60 秒超时自动释放，关界面同样触发释放，材料不会永久卡死。

合成与解锁

function Craft.run(plr)
    local recipeId = plr.craftLock
    if not recipeId then return false end
    local recipe = RECIPES[recipeId]
    for _, need in ipairs(recipe.cost) do
        QF_CostLockedItem(plr, need.id, need.n)
    end
    plr.craftLock = nil
    local out = math.random(1, 100) <= recipe.critRate
    QF_GiveItem(plr, out and recipe.critOut or recipe.out, 1)
    return true
end

锁定材料扣除后立刻释放锁，暴击配方按概率产出双倍品质，10% 暴击率带来持续惊喜。合成失败率归零的设计最省客诉：材料必出成品，差异只在品质，玩家没有血本无归的挫败。配方树进配置表，新增配方不改代码，材料不足时红点提醒并标注缺口数量。合成台界面用 GUI 图标阵列渲染配方，产成品预览图带品质光效。

验证与监控

材料消耗与成品产出按配方对账，比例失衡即查锁机制的漏洞。

踩坑记录

锁定超时最初只有 30 秒，玩家打开银行取材料的工夫锁已释放，回来提交时材料被别人扣走，延长到 60 秒并在开银行时给材料加只读提示。暴击双倍品质的产出曾经可以回炉再合成套利，精炼黑铁拆回普通黑铁的比率被算得明明白白，配方链加了产成品不可再合成标记后堵住。配方的产耗回路要在设计期画完，上线后再补漏的成本是十倍。合成界面的材料明细支持悬停查看获取途径，缺三块矿石的玩家能直接跳转到对应产地，合成与玩法的动线连成一步。预锁定的并发测试用脚本模拟了千次同时提交，无一例超扣，锁机制的正确性有自动化用例长期看护。配方表的数据结构在两次扩展后保持稳定，材料组、产物组、暴击配置三段式结构支撑了十余个资料片的配方新增，良好的抽象会让系统活得比预期久。合成界面的材料明细支持悬停查看获取途径，缺三块矿石的玩家能直接跳转到对应产地，合成与玩法的动线连成一步。预锁定的并发测试用脚本模拟了千次同时提交，无一例超扣，锁机制的正确性有自动化用例长期看护。配方表的数据结构在两次扩展后保持稳定，材料组、产物组、暴击配置三段式结构支撑了十余个资料片的配方新增，良好的抽象会让系统活得比预期久。

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