玩家的状态开关几十个: silence、隐身、无敌、伪装、看聊天的屏蔽位——每个开关存一个字段太浪费。位标志用一个数字的各个二进制位存 32 个开关,Lua 没有位运算符就用算术模拟,跨版本通用。
---位标志的读取:第 k 位是 0 还是 1
local function getFlag(flags, k)
return math.floor(flags / 2 ^ k) % 2
end
---标志的置位:把第 k 位置 1
local function setFlag(flags, k)
local bit = getFlag(flags, k)
if bit == 1 then return flags end
return flags + 2 ^ k
end
---标志的清除:把第 k 位置 0
local function clearFlag(flags, k)
local bit = getFlag(flags, k)
if bit == 0 then return flags end
return flags - 2 ^ k
end
位标志的三个原语全用算术实现:读取是「除以 2 的 k 次方再对 2 取模」,置位是加 2 的 k 次方(先判已置避免重复加),清位是减 2 的 k 次方(先判已清避免减成负数)。不用位运算符的原因是版本兼容:Lua 5.1 没有 bit 库,算术版在任何 Lua 环境都跑得通。一个 flags 字段存 32 个开关,setplayvar 落库一个数字,持久化的成本趋近于零。
---玩家的状态开关:flags 字段的落库
local FLAG = {
SILENCE = 0, INVISIBLE = 1, NO_TRADE = 2,
AUTO_REPLY = 3, SHIELD = 4, FROZEN = 5,
}
function State.has(actor, key)
local flags = tonumber(getplayvar(actor, 2, "Flags")) or 0
return getFlag(flags, FLAG[key]) == 1
end
function State.set(actor, key, on)
local flags = tonumber(getplayvar(actor, 2, "Flags")) or 0
local newFlags = on and setFlag(flags, FLAG[key])
or clearFlag(flags, FLAG[key])
setplayvar(actor, "HUMAN", "Flags", newFlags, 1)
end
业务侧的读写收口到 State 门面:开关的名字进 FLAG 字典(名字到位的映射),业务代码写 State.has(actor, "SILENCE") 而不是对魔法数字做算术——可读性与持久化效率同时拿到。掩码的批量操作:一次置位多个相邻的开关可以用掩码段(比如前 8 位一组加 255),组操作的语义按业务分组设计。flags 的调试打印:把数字展开成 32 位的 01 串输出,排查状态冲突时一目了然。
位标志的单元测试覆盖 0 到 31 的每一位:置位、清位、读取、再置位的往返断言;flags 数值的异常监控,出现负数或超界即为算术的越界。
置位曾经不判已置重复加,偶发的翻倍让相邻的开关被连带置位,先判后加修复。2 的 k 次方曾经用 ^ 运算符——Lua 的 ^ 是乘方没错但优先级低于预期,加括号的显式写法根治。flags 的落库曾经是字符串,读回 tonumber 的失败让全部开关静默归零,数值类型的强制转换。
开关的字典与业务模块一一对应,新增开关只登记字典不改存储。flags 的数值在管理后台可展开为位视图,运营排查状态时所见即所得。批量置位的掩码常量进公共库,手算掩码的错误从此绝迹。
全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
实战应用:用在哪里 版本更新上线后突然下架了某件热销商品,但更新公告里没有提到这件事。玩家发现后截图传播,两小时内贴吧帖子超…
实战应用:用在哪里 技能升级后缺少视觉与听觉反馈,玩家不确定升级是否成功。技能升级反馈在升级成功的瞬间展示金色光效、播放升级…
实战应用:用在哪里 点击其他玩家的角色时默认弹出查看面板,但在战斗中玩家希望点击即攻击。双击检测在单击查看的基础上增加双击攻…
实战应用:用在哪里 灵宠在战斗中作用有限,玩家养了宠物但缺少日常互动。灵宠派遣让宠物成为玩家的探索伙伴:派遣灵宠外出探索获取…
实战应用:用在哪里 宠物养成线只有喂食和升级,缺少宠物之间的对抗玩法。宠物竞技让两只宠物在专属竞技场进行自动对战,玩家通过调…
实战应用:用在哪里 测试环境直接复制生产库会把真实玩家数据暴露给开发和测试人员,存在隐私泄露风险。脱敏测试库的搭建分三步:从…