【框架设计】副本重置机制：每日重置与进度保存的可靠实现

实战应用：用在哪里

副本的重置有两层含义：每日重置（挑战次数、进度清零，新的一天重新开始）与失败重置（队伍团灭后回到入口重来）。重置实现出错的表现：进度残留到第二天、重置后奖励可重复领取、团灭后无法重新进入。可靠的副本重置需要一个明确的重置锚点与一份进度快照。

每日重置：重置锚点用日期字符串

进度数据带"所属日期"标记，玩家进入或保存进度时写入当天的日期串（2026-09-20）。读取进度时比对日期串与今天：

local function getTodayProgress(playerId, dungeonId)
    local p = loadProgress(playerId, dungeonId)
    if p and p.date ~= todayStr() then
        p = newProgress()          -- 跨天：进度整体重置
        p.date = todayStr()
        saveProgress(playerId, dungeonId, p)
    end
    return p
end

todayStr 按服务器维护后的时间计算，避免凌晨零点前后进度的边界争议（有的游戏用凌晨五点做业务日切点，按运营策略配置）。

失败重置：入口状态与进度快照

团灭后的重置是"回到副本初始状态"：怪物复活、机关复位、队伍回到入口。实现要点：副本开启时保存初始快照（怪物清单与位置），重置时按快照重建；玩家进度（已击杀计数）按策略决定是否保留（扫荡类保留、机制类清零）。重置次数限制（失败重试 3 次）在副本对象上计数，超限踢出副本并进入冷却。

与邮件补发的配合

副本进度丢失的补偿走邮件（参考邮箱系统篇）：检测到进度异常重置时，把应得奖励折算成邮件补偿。重置日志（谁、哪个副本、何时重置、原因）全部留痕，客诉的每一个问题都有据可查。副本重置的可靠实现是"状态 + 锚点 + 快照 + 补偿"四件事的组合，缺一环就多一类客诉。

重置日志的字段清单

重置日志固定五个字段：副本 id、玩家或队伍 id、重置原因（每日/团灭/手动）、重置时间、保留的进度摘要。字段清单进团队文档，运维与客服按同一份清单提问与作答，重置类问题的沟通成本会明显下降。

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