【后端接口】setflagstatus：标志位接口与任务标记

实战应用：用在哪里

setflagstatus 是引擎的标志位接口：任务完成标记、副本首杀记录、活动参与状态这类"做过没有"的布尔信息全存标志位。标志位的存储按位压缩，一个整数可以承载 30 个标记，是任务系统最经济的存储方案。

接口签名与设置

---设置标志位 actor:玩家 nIndex:标志索引 nvalue:状态
function setflagstatus(actor, nIndex, nvalue) end

-- 主线任务 1001 完成标记
setflagstatus(actor, 1001, 1)

-- 查询标志
local done = getflagstatus(actor, 1001)

nIndex 是标志位的索引（任务系统按任务 ID 占用索引段），nvalue 置 1 打开标记、置 0 清除。标志位的查询配合任务的状态机：接任务前查前置标志、交任务时写完成标志，状态流转的每一步都有位可查。

标志位的分段管理

-- 标志段位的分配约定
-- 1000-1999：主线任务
-- 2000-2999：日常活动
-- 3000-3999：副本首杀
function QuestFlag.section(taskId)
    if taskId >= 1000 and taskId < 2000 then return 1000 end
    return 0
end

标志索引按业务分段：主线千段、活动两千段、副本三千段，段位的分配表防止不同系统的标志互相覆盖。标志位的持久化随角色存档，落库的时机与存档策略一致。标志的批量清除（重置活动）按段遍历，段内的标志统一归零。

验证与监控

标志位的写入与查询流水按段统计，异常高频的写入定位到具体业务修复。

踩坑记录

标志索引的冲突曾经让两个活动共用同一个位，互相覆盖的表现是"完成了 A 活动 B 的奖励也发了"，段位分配表上线后冲突归零。标志的清除曾经误删了永久成就的标记，成就与活动的标志分段隔离后，清理的范围有边界。

上线要点

标志位的使用规范：一个索引只表达一个独立语义，位运算的复用技巧增加排查成本不推荐。标志的查询接口给任务系统与成就系统共用，查询的频率在触发器里密集，接口的 O(1) 实现是性能的前提。标志的迁移：引擎升级时标志位的存储格式变化要有转换脚本，老档的标志不丢失。

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