CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
进阶实战996引擎攻城阶段状态机

【进阶实战】攻城战阶段:多阶段切换的状态机封装

2026-09-25 00:15 作者:996 技术组 996引擎Lua教程传奇脚本进阶实战996引擎Lua攻城阶段状态机

业务场景

沙巴克攻城有四个阶段:报名(3 天)、备战(1 小时)、开战(2 小时)、结算(30 分钟)。阶段判定散落在报名入口、传送门、结算脚本各自为政——某台机器时区配置偏了,开战时间提前了 10 分钟,报名期玩家被传送门拒收。阶段状态机封装:时间轴统一定义,当前阶段由单一函数判定,阶段切换边界只触发一次切换动作。

核心实现

阶段时间轴与切换检测:单点判定加边界回调。示例代码如下:

lua
local STAGES = {
    { name = "报名", from = 0, lastSec = 259200 },
    { name = "备战", from = 1, lastSec = 3600 },
    { name = "开战", from = 2, lastSec = 7200 },
    { name = "结算", from = 3, lastSec = 1800 },
}
local stageStart = os.time()
local lastStage = 0
local function currentStage()
    local elapsed = os.time() - stageStart
    for i = #STAGES, 1, -1 do
        local offset = 0
        for j = 1, i do
            offset = offset + STAGES[j].lastSec
        end
        if elapsed < offset then
            return i
        end
    end
    return #STAGES
end
local function onStageEnter(stageId)
    sendcentermsg(nil, 249, 255, "攻城进入【" .. STAGES[stageId].name .. "】阶段", 0, 8, "")
    setsysvarex("SiegeStage", stageId, 1)
end
local function tickStage()
    local cur = currentStage()
    if cur ~= lastStage then
        lastStage = cur
        onStageEnter(cur)
    end
end

报名入口按阶段放行示例代码如下:

lua
local function canSignup()
    return currentStage() == 1
end

接口拆解

STAGES 时间轴只声明名称与时长,当前阶段由 currentStage 用累计偏移一次性判定——判定逻辑只有一份,四散的 if 从根上消失。tickStage 每分钟被全局定时器调一次,lastStage 与当前比对,只有变化才触发 onStageEnter,边界动作(公告、落库、开关切换)天然只执行一次。SiegeStage 落库让重启后的恢复逻辑知道当前处于哪个阶段。

踩坑记录

阶段状态机踩过三个坑:一是两台机器时秒级时钟偏差导致同一毫秒内 tick 两次都判定为"新阶段",切换动作执行了两遍——lastStage 比对与赋值要在同一次 tick 内完成且切换动作幂等;二是运营改错时间配置导致阶段回拨(从结算跳回开战),状态机按 currentStage 单向判定时回拨会被当作正常切换执行,加一条"只允许前进"的守卫,回拨打告警并拒绝;三是结算阶段读取开战期数据(占领行会)发现是空值,开战数据在阶段切换时没落库,切换钩子里必须把关键数据先固化再广播。

作者履历与出处

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

← 返回文章地图返回研学路径

最新技术文章 · 实战干货

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

高级技巧996引擎

【高级技巧】Lua常量提升:祖玛教主掉落表别在函数里重建

一、一行代码拆解:local function roll() 里写 local cfg = {500, 200, 50} —…

2026-09-26 05:50 996 技术组
进阶实战996引擎

【进阶实战】Lua数值精度上限:沙巴克国库囤金的2^53错账

一、隐蔽陷阱:国库金币累加到 2^53(约 9007199254740992)之后再加 1,数值纹丝不动——双精度浮点在该区…

2026-09-26 05:50 996 技术组
策划架构996引擎

【策划架构】Lua模块表单例:裁决之杖仓库的单一入口封装

一、线上事故:仓库存取逻辑散在 6 个脚本,各自写各自的 getsysvar 键名,某次改名漏改 2 处,300 件裁决之杖…

2026-09-26 05:50 996 技术组
策划架构996引擎

【策划架构】Lua分页切片:沙巴克战备仓库500件的翻页设计

一、抛坑提问:500 件战备装备一次下发必卡,按每页 20 件切片,边界怎么算才不出空页和重页?起点 (page-1) 20…

2026-09-26 05:50 996 技术组
进阶实战996引擎

【进阶实战】Lua error层级参数:烈火剑法报错定位到调用行

一、抛坑提问:校验失败在工具函数里 error,日志却指向工具函数那一行,排查总要翻两层。error 第二参 level 能…

2026-09-26 05:50 996 技术组
高级技巧996引擎

【高级技巧】Lua局部量200上限:裁决之杖仓库函数的寄存器分配

一、一行代码拆解:local a1, a2, a3 …… —— 单个函数最多 200 个活跃局部量,这是编译期硬限制;局部量…

2026-09-26 05:50 996 技术组