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

【进阶实战】工厂模式:按类型创建副本实例

2026-09-24 23:15 作者:996 技术组 996引擎Lua教程传奇脚本进阶实战996引擎Lua工厂模式副本实例

业务场景

副本系统有单人本、组队本、行会本三类实例,创建逻辑散落三处 if-elseif:每类各写一套初始化,公共字段(创建时间、状态、人数上限)有的设了有的漏设——行会本漏设状态字段,创建出来直接是 nil 状态无法进本。新增"师门本"要改 5 处分支。工厂模式封装:类型到构造器的一张注册表,新增类型注册一行,公共初始化收敛到工厂内部统一做。

核心实现

构造器注册表与统一创建入口:公共字段工厂兜底,类型差异各注册。示例代码如下:

lua
local creators = {}
local function registerCreator(typeId, fn)
    creators[typeId] = fn
end
local function newInstance(typeId, cfg)
    local creator = creators[typeId]
    if creator == nil then
        sendmsg(nil, 1, "未知副本类型:" .. tostring(typeId))
        return nil
    end
    local inst = {
        typeId = typeId,
        state = "open",
        createTime = os.time(),
        maxPlayers = 5,
    }
    creator(inst, cfg)
    return inst
end
registerCreator("solo", function(inst, cfg)
    inst.maxPlayers = 1
    inst.boss = "沃玛教主"
end
)
registerCreator("guild", function(inst, cfg)
    inst.maxPlayers = 30
    inst.guild = cfg.guild
    inst.boss = "祖玛教主"
end
)

新增师门本只注册一行:示例代码如下:

lua
registerCreator("mentor", function(inst, cfg)
    inst.maxPlayers = 6
    inst.master = cfg.master
end
)
local inst = newInstance("guild", { guild = "兄弟情深" })

接口拆解

creators 是类型到构造函数的注册表,newInstance 统一做公共初始化(typeId、状态、创建时间、默认人数上限),再把实例交给类型构造器覆盖差异字段——公共字段漏设的问题在结构上绝根。注册制让新增类型从"改 5 处分支"变成"注册 1 行",分支层数不再随类型增长。未知类型在工厂入口拒绝并提示,坏类型进不了系统。

踩坑记录

工厂模式踩过三个坑:一是某类型构造器里又把 state 覆盖成 nil(想做"未开启"却写成了 nil 赋值),工厂兜底的状态被冲掉,构造器内只允许覆盖不允许清空公共字段,评审时盯紧;二是类型 ID 用字符串拼写("Guild" 与 "guild" 混用),注册表查不到静默返回 nil,调用方拿到 nil 实例继续用报错,类型 ID 收敛成常量表统一引用;三是构造器内部调用外部服务失败(读配置落空)时实例已创建一半,工厂要支持构造器报错时回收实例并返回 nil,半成品实例绝不出厂。

作者履历与出处

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

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

幂尔框架 · 实战干货 · 接口调用

LATEST ARTICLES

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

策划架构996引擎

【策划架构】Lua __metatable保护:裁决之杖插件防篡改设计

一、抛坑提问:三方增强插件直接 getmetatable(weapon) 拿到元表,把裁决之杖攻击改到 9999。元表能不能…

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

【策划架构】Lua rawget直读:祖玛商店价目表的存取分层

一、一行代码拆解:rawget(PriceList, name) —— 这一行绕过元表直达表本体,价目查询不走 __inde…

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

【高级技巧】Lua table.remove倒序删:沙巴克守城名单的移位陷阱

一、隐蔽陷阱:沙巴克守城名单清理离线成员,正序 for 循环里 table.remove(list, i),删一个后续整体前…

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

【策划架构】Lua loadstring公式:裁决之杖动态调价的架构封装

一、线上事故:运营要按供需公式浮动裁决之杖价格,某次把表达式字符串直接塞进裸 loadstring 执行,串里夹带未知全局调…

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

【进阶实战】Lua取模与负数:红名值衰减进度的回绕错误

一、线上事故:红名洗白进度按 10 段槽位刷新,GM 修正过 PK 值的玩家带着 -8 的负值进来,进度槽算出 -2,进度条…

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

【高级技巧】Lua unpack展开:烈火剑法连招的动态传参

一、抛坑提问:烈火剑法连招表存着 4 段延时 {200, 400, 600, 900},算总窗要逐个相加。段数扩到 6 段,…

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