裁决之杖的 ID 是 101 还是 110?战士的职业码是 0 还是 1?散落在各处的魔法数字是维护的地狱:改一个枚举全代码库搜一遍。数据字典把枚举收进单一来源,代码读字典、配置写字典、文档查字典。
---数据字典:枚举的单一来源
local Dict = {
JOB = { warrior = 0, mage = 1, taoist = 2 },
QUALITY = { white = 1, blue = 2, gold = 3 },
SLOT = { weapon = 1, helmet = 2, armor = 3 },
}
function Dict.nameOf(group, value)
for name, v in pairs(Dict[group]) do
if v == value then return name end
end
return "unknown"
end
---业务侧的引用:不再出现裸数字
function Equip.canWear(actor, itemDef)
local player = class(actor)
if not player then return false end
local job = tonumber(getplayvar(actor, 2, "Job")) or 0
return itemDef.job == Dict.JOB.warrior and
job == Dict.JOB.warrior
end
字典按组组织枚举:职业、品质、装备位各自一组,业务代码引用 Dict.JOB.warrior 而不是写 0——魔法数字的消亡让代码自解释。反向的查询 nameOf 把值翻译回名字,日志与告警里的可读性由字典兜底:告警说「职业 2 校验失败」没人懂,说「职业 taoist 校验失败」秒懂。字典的变更走版本管理:新增枚举值是加法安全,改值与删值必须全库的影响面评审。
---配置装载时的字典校验
function Dict.validate(cfgTable, group, field)
for i, row in ipairs(cfgTable) do
local v = row[field]
if v and not Dict.hasValue(group, v) then
Ops.alert(("配置第 %d 行 %s 字段的 %s 不在字典")
:format(i, field, tostring(v)))
return false
end
end
return true
end
---物品表的职业字段全量校验
function Dict.onLoad()
Dict.validate(ITEM_TABLE, "JOB", "job")
Dict.validate(MON_TABLE, "QUALITY", "quality")
end
字典的实施靠装载期的校验:配置表的枚举字段逐一比对字典,不在字典里的值当场告警拒绝装载——配置里写了职业 3(不存在)的事故在启动时就爆出来。字典与配置文档的生成联动:文档里的枚举说明由字典导出,两份真相合成一份。跨团队的口径统一是字典的隐性价值:客户端、服务器、运营后台共用同一份枚举的定义文件,三端的职业码口径一致,配合文档的导出,打架的事故从此绝迹。
字典的引用率统计:裸数字的残留扫描进代码检查,字典外的魔法数字逐个清剿;字典变更的影响面报告,每次改动的引用清单自动生成。
字典曾经允许重复的值(两个名字同一个码),反向查询的歧义让翻译随机,值的唯一性约束补上。枚举的删除曾经直接删行,历史数据里的旧值失去解释,删除改为废弃标记保留映射。字典的加载曾经在配置校验之后,校验用的字典还是空的,加载顺序倒置的事故让初始化的依赖图显式化。
字典的编辑权限收敛,新增走评审、修改走公告。字典的导出覆盖三端:客户端的常量文件、服务器的模块、后台的下拉选项同源生成。新枚举的接入清单:字典登记、配置校验、文档导出三步走全。
本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付,内容以官方知识库与真实项目为出处,按版本持续修订。
全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
实战应用:用在哪里 明拍容易被大号威慑,普通玩家不敢出手。秘宝暗拍改为全服暗标:每周一件秘宝,玩家密价投标一次,截标前互相看…
实战应用:用在哪里 充值返利活动被风控规则误判成套利,480 个大额充值账号被批量封禁 24 小时,申诉两小时破千条。误封风…
实战应用:用在哪里 五人小队打沃玛教主,队友的血量状态只能靠点头像逐个看,集火转火慢半拍。小队血条在屏幕侧边紧凑排布四条队友…
实战应用:用在哪里 好友申请藏在好友面板的角标里,玩家半天不看一眼,申请积压让社交转化掉了一半。好友申请浮窗把新申请推到屏幕…
实战应用:用在哪里 矿洞产出人人有份等于人人不重视,矿位租赁把矿洞变成可经营资产:矿位按 24 小时租给个人或行会,产出归租…
实战应用:用在哪里 击杀 BOSS 后要同时做三件事:发奖励、记流水、刷新排行榜,全都写在 killmon 触发里互相拖累,…