CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
后端接口师门权限

【后端接口】师门职务定岗:岗位任命与权限校验的接口设计

2026-09-23 16:56 作者:996 技术组 996引擎Lua教程传奇脚本

实战应用:用在哪里

师门成长到四五十人,掌门一人管不动:定岗接口把师门分成掌门、长老、执事、弟子四级,长老管收人、执事管开课,职务与权限在接口层绑定,师门管理从单人扛变成分层管。

定岗的授予与校验

定岗入口校验操作者的职务等级,只能任命比自己低一级的职务。actor是字符串,转对象后读写师门职务。

lua
local ROLE_LV = { master = 4, elder = 3, steward = 2, pupil = 1 }
local function assignRole(actor, targetName, role)
    local player = class(actor)
    local myLv = ROLE_LV[getplayvar(actor, 2, "SM_ROLE") or "pupil"] or 1
    local targetLv = ROLE_LV[role]
    if targetLv == nil or targetLv >= myLv then
        sendmsg(actor, 0, "只能任命低于自身职务的岗位")
        return
    end
    local t = getplayerbyname(targetName)
    if t == nil or not isplayer(t) then
        sendmsg(actor, 0, "目标弟子不在线")
        return
    end
    setplayvar(t, "HUMAN", "SM_ROLE", role, 1)
    sendmsg(t, 0, "受命担任师门" .. role)
end

权限闸口的统一校验

师门的开课、资源审批等操作走统一权限闸口,职务等级达标才放行,越权操作留痕。actor是字符串,转对象后校验权限。

lua
local NEED_LV = { open_class = 2, approve_item = 3 }
local function gateCheck(actor, op)
    local player = class(actor)
    local myLv = ROLE_LV[getplayvar(actor, 2, "SM_ROLE") or "pupil"] or 1
    local need = NEED_LV[op] or 4
    if myLv < need then
        setsysvarex("SM_DENY", os.date("%m%d%H%M") .. "|" .. class(actor):GetName() .. "|" .. op, 1)
        sendmsg(actor, 0, "该操作需要更高职务")
        return false
    end
    return true
end

验证与监控

四级职务的权限矩阵逐格验证;越权拒绝与留痕成对出现。上线后统计各职务的操作量分布,执事的审批量长期为零说明职责划分有名无实,岗位设置要按真实管理动线调整。

踩坑记录

SM_ROLE存字符串角色,掌门离线时重大操作的代理权限要显式授权,默认拒绝比默认放行安全。NEED_LV的等级要求与ROLE_LV联动的耦合要在配置里对齐,两表各自为政会造成权限错位。setsysvarex留痕只存末条,完整审计走文件,审计日志按月归档。目标离线时拒绝定岗还是缓存补授,选缓存补授要把离线名单的清理周期想清楚。

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

后端接口成就属性加成

【后端接口】成就点数兑换:全局属性加成的结算接口设计

实战应用:用在哪里 成就点数不该只是数字摆设:点数商店兑换永久属性加成,50分换百分之一攻击,上限百分之五。兑换接口管三件事…

2026-09-23 17:04 996 技术组
界面UI

【界面UI】UI 合图自动化:纹理打包流水线与命名规范

实战应用:用在哪里 UI 合图(把零散小图打包成图集)是 DrawCall 合批的前提(合批原理参考前篇)。手工打包的问题:…

2026-09-23 17:04 996 技术组
数据存储

【数据存储】SQLite WAL 模式:读写并发实测与开启方法

实战应用:用在哪里 SQLite 默认的回滚日志模式在写入时会阻塞读取(写锁独占),游戏服务端“边写日志边查配置”的场景会出…

2026-09-23 17:04 996 技术组
框架设计

【框架设计】PK 模式:攻击范围的开关与误伤保护

实战应用:用在哪里 烈火剑法甩出去的瞬间最怕砍到队友:PK 模式是攻击的准星开关——和平、组队、行会、全体四种模式决定谁的技…

2026-09-23 17:04 996 技术组
玩法策划大逃杀缩圈

【玩法策划】大逃杀缩圈:借鉴吃鸡玩法的安全区收缩设计

实战应用:用在哪里 把大逃杀的缩圈机制搬进沙巴克野区:五十人无阵营乱斗,安全区每六十秒收缩一圈,圈外持续掉血,终局幸存者独享…

2026-09-23 17:04 996 技术组
运维发布停服维护运营

【运维发布】发布窗口选择:用在线人数曲线定停服时机

停服更新最怕撞上在线高峰,踢掉几百人换来一片抱怨。选对发布窗口,同样的更新内容,玩家体验是两回事。本文讲如何用996引擎的在…

2026-09-23 17:04 996 技术组