【框架设计】挂机系统：自动战斗状态机与脱战回归实现

实战应用：用在哪里

挂机是传奇类引擎时长与留存的核心功能：玩家开启自动后，角色自行索敌、施放技能、拾取与回城补给，深夜挂机刷材料是老玩家的日常。996 引擎后端用状态机驱动挂机流程，状态之间互不纠缠，单个状态出错不拖垮整条链路，回归点清晰可查。

状态机骨架

local STATES = { IDLE="idle", HUNT="hunt", FIGHT="fight", BACK="back" }
function AutoFight.update(plr)
    local fn = AutoFight[plr.autoState or STATES.IDLE]
    if fn then pcall(fn, plr) end
end

function AutoFight.hunt(plr)
    local mon = QF_FindNearMonster(plr, 800)
    plr.autoState = mon and STATES.FIGHT or STATES.IDLE
end

AutoFight.update 由后端定时器每秒驱动一次，QF_FindNearMonster 在 8 格半径内索敌，优先攻击玩家上次击杀的怪物类型。状态函数全部用 pcall 包裹，配合 xpcall 记录调用栈，故障堆栈进 GM 审计报表，运维定位单点问题不影响其他状态的正常运行。

脱战与补给判定

function AutoFight.fight(plr)
    if plr.hp < plr.maxHp * 0.2 then
        plr.autoState = STATES.BACK
        QF_UseItem(plr, 1001, 1)
        return
    end
    if os.time() - (plr.lastHurtAt or 0) > 15 then
        plr.autoState = STATES.HUNT
    end
end

血量低于 20% 转入回城补给，脱战 15 秒后重新索敌。补给时顺带检查背包负重，超过八成自动回城卖物清包，避免挂机两小时原地空转。死亡处理单独一路：原地复活石充足就原 地复活，否则回城复活后从最近存档点重新出发。挂机日志按小时聚合进入状态次数、平均战斗时长与补给药量，数值组据此调整索敌半径与补给阈值，客户端开关按钮用 GUI:addOnClickEvent 绑定挂机指令，状态变化实时同步头顶图标。

验证与监控

上线前用机器人账号跑 24 小时连续挂机，要求零中断率 99% 以上；线上监控每小时的异常中断次数，突增即告警。

踩坑记录

补给阈值定在 20% 看似保守，实战里法师开盾的承伤曲线很陡，血线跌破两成时往往已经被围，回城路线直接被截断。后来补了一条预判：承伤速率超过每秒 3% 就提前触发补给，挂机中断率从 4% 压到 1%。状态机的 pcall 一度被写成条件调用，某个异常状态卡死后整晚没人发现，那次之后补了状态停留时长监控，同一状态停留超过 60 秒即告警，问题在下一轮巡检就能被看见。

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