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

【进阶实战】黑名单同步:屏蔽名单的即时生效封装

2026-09-24 10:13 作者:996 技术组 0 阅读 996引擎Lua教程传奇脚本进阶实战996引擎Lua黑名单社交屏蔽

业务场景

玩家被红名骚扰后把对方拉黑,期待的是"立即世界清净":私聊收不到、组队邀约弹不进、好友申请自动婉拒。屏蔽名单的工程要点:名单存玩家个人变量(服务端权威)、所有社交入口统一过闸、拉黑即时生效不依赖重登。

核心实现

屏蔽与解除:名单以竖线分隔存个人变量,add 与 remove 对称。示例代码如下:

lua
local function blockAdd(actor, targetName)
    actor = getplayerbyname(actor)
    local list = getplayvar(actor, "HUMAN", "BlockList") or ""
    if string.find(list, targetName, 1, true) then
        sendmsg(actor, 1, "对方已在黑名单中。")
        return
    end
    list = list == "" and targetName or (list .. "|" .. targetName)
    setplayvar(actor, "HUMAN", "BlockList", list, 1)
    sendmsg(actor, 1, targetName .. " 已拉黑,社交消息即刻屏蔽。")
end
local function blockRemove(actor, targetName)
    actor = getplayerbyname(actor)
    local list = getplayvar(actor, "HUMAN", "BlockList") or ""
    local kept = {}
    for name in string.gmatch(list, "[^|]+") do
        if name ~= targetName then
            kept[#kept + 1] = name
        end
    end
    setplayvar(actor, "HUMAN", "BlockList", table.concat(kept, "|"), 1)
    sendmsg(actor, 1, targetName .. " 已移出黑名单。")
end

统一过闸:私聊、组队邀请、好友申请三个入口共用同一个校验函数。示例代码如下:

lua
local function isBlocked(actor, fromName)
    actor = getplayerbyname(actor)
    local list = getplayvar(actor, "HUMAN", "BlockList") or ""
    return string.find(list, fromName, 1, true) ~= nil
end
local function onPrivateMsg(actor, fromName, content)
    actor = getplayerbyname(actor)
    if isBlocked(actor, fromName) then
        sendmsg(getplayerbyname(fromName), 1, "对方暂时无法接收消息。")
        return
    end
    sendmsg(actor, 1, "[私聊]" .. fromName .. ":" .. content)
end

接口拆解

getplayvar/setplayvar 第五参 1 落库:黑名单是玩家的社交资产,重启不能清零。string.find 第四参 true 纯文本查找,玩家名带特殊字符零风险。isBlocked 作为唯一闸门函数被三个入口复用——屏蔽逻辑只写一处,新增社交入口时接一行闸门即可。blockRemove 的重建清单写法(过滤后 concat 回写)是列表删除的标准模式。

踩坑记录

黑名单同步踩过三个坑:一是只在私聊入口过闸,组队邀请与好友申请照常穿透,"屏蔽得不够干净"的投诉一半来自漏接的入口——闸门必须收编全部社交触点;二是名单无上限,恶意囤了五百个名字后变量超长被截断尾部,名单加 100 人上限;三是解除名单时用 string.gsub 直接删名字,子串误伤("张三"删掉了"张三丰"),逐条过滤重建才是安全做法。

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

策划架构996引擎

【策划架构】玩法日历:活动排期的疲劳度预算设计

设计初衷 活动排期凭感觉:周末连开三个重头活动,玩家疲于奔命参与率反跌;工作日大空窗,在线曲线断崖。玩法日历设计:以周为单位…

2026-09-25 11:34 996 技术组 · 0 阅读
策划架构996引擎

【策划架构】掉线补偿:分级处置与申诉留痕设计

设计初衷 网络波动掉线让玩家损失战斗进度:世界BOSS打到一半掉线,回来残局已清;副本中掉线,门票作废。掉线补偿设计把掉线当…

2026-09-25 11:34 996 技术组 · 0 阅读
高级技巧996引擎

【高级技巧】圆周等距布点:环绕阵列的坐标生成封装

底层原理 祭坛围一圈火把、世界BOSS周身一圈水晶,这类环绕阵列需要等角度分布坐标:圆心 (cx, cy)、半径 r、数量 …

2026-09-25 11:34 996 技术组 · 0 阅读
策划架构996引擎

【策划架构】影子榜:追赶目标的邻座排名设计

设计初衷 排行榜只有顶端可见:进不了前一百的玩家在榜上查无此人,名次没有参照,追赶没有对象。影子榜设计:为每名玩家生成以自己…

2026-09-25 11:34 996 技术组 · 0 阅读
进阶实战996引擎

【进阶实战】副本重置投票:队伍表决的过半重置封装

业务场景 打错路线或主力减员后想重来,队长单方面重置常引发队内矛盾,误触重置的投诉也不少。投票重置封装:重置需全队表决、同意…

2026-09-25 11:34 996 技术组 · 0 阅读
高级技巧996引擎

【高级技巧】校验和:存档完整性的算术校验封装

底层原理 存档在写入与传输中可能因意外损坏,读档前需要一道完整性判定。校验和的思路:把数据逐字节累加压缩成一个整数指纹,读档…

2026-09-25 11:34 996 技术组 · 0 阅读