【框架设计】成就系统：条件检测与进度推送的实现

完整课程入口：996 全套课程体系 ｜ Lua 学习路径 ｜ 幂尔框架 mirs.cn

实战应用：用在哪里

成就系统覆盖击杀、收集、成长、社交四类目标，是玩家长期目标的承载框架。成就的三个核心机制：条件检测（何时判定达成）、进度推送（达成前的进度感知）、奖励发放（达成后的统一出口）。结构化的成就框架让新成就的接入变成一条配置。

成就定义与检测

每个成就声明类型、目标值与进度来源：

local ACH = {
    kill_wolf_50 = { type = "counter", key = "kill:wolf", goal = 50 },
    equip_all_epic = { type = "flag_check", fn = function(p)
        return countEpicEquips(p) >= 6 end },
    reach_lv80 = { type = "snapshot", key = "level", goal = 80 },
}

function ACH.progress(p, id)
    local def = ACH[id]
    if def.type == "counter" then return p.counters[def.key] or 0, def.goal end
    if def.type == "snapshot" then return p[def.key] or 0, def.goal end
    if def.type == "flag_check" then
        local ok = def.fn(p)
        return ok and def.goal or 0, def.goal
    end
end

三类模板覆盖绝大多数成就：计数型（累计击杀）、快照型（达到等级）、判定型（自定义函数）。策划配一个模板类型与目标值即可新增成就。

进度推送与奖励出口

进度变化统一走推送入口：计数器更新时检查关联成就的进度，进度跨越 25%/50%/75% 阈值时给客户端发进度消息（前端做进度提示），达成时发达成事件。奖励发放走统一出口（与邮箱系统对接）：达成事件触发后校验未领取过（成就 id + 玩家 id 的发放流水），再走邮箱发奖。三段式（检测、推送、发放）各自独立，任何一段改动不影响另外两段。

计数器的写入纪律

计数型成就依赖 counters 表的准确性：计数写入入口收敛到 p.count(key, n) 单点，禁止业务散落自加。离线期间的计数（离线经验转化）在登录合并时统一补记。成就表的全部成就启动时加载为内存配置，progress 查询为纯内存操作。这套框架下，新增一个"击杀 100 只 Boss"的成就就是一行配置加一条运营公告，接入成本与维护成本都被压到最低。

成就进度的存储按玩家分表或分键，避免全服成就进度挤在一张大表。进度推送的阈值判断放在计数写入处统一执行，业务调用方无感知，新增成就不需要改动任何计数代码。