【安全加密】黑名单：屏蔽聊天与屏蔽组队的双闸

实战应用：用在哪里

黑名单是玩家社交的自主防护工具：拉黑后对方不能私聊、不能组队邀请、不能交易邀请。黑名单的双闸设计（聊天闸与组队闸）独立工作又互相补位，被拉黑者不知道自己被拉黑（单向静默），骚扰者得不到反馈就少一轮纠缠。

拉黑与解除

function BlackList.block(userId, blockedId)
    local key = userId .. "->" .. blockedId
    blacklist[key] = os.time()
    sendmsg(getplayerbyname(userId), 1, "已拉黑对方")
end

function BlackList.unblock(userId, blockedId)
    local key = userId .. "->" .. blockedId
    blacklist[key] = nil
    sendmsg(getplayerbyname(userId), 1, "已取消拉黑")
end

拉黑的单向静默：对方不知道自己被拉黑，私聊的消息正常发送但不送达，骚扰者得不到反馈就少一轮纠缠。黑名单的上限 50 人，上限溢出时拒绝新拉黑并提示清理。

双闸的拦截

function ChatFilter.isBlocked(sender, receiver)
    local key = sender .. "->" .. receiver
    return blacklist[key] ~= nil
end

function TeamFilter.canInvite(leader, invitee)
    local key = invitee .. "->" .. leader
    return blacklist[key] == nil
end

聊天闸检查发送者是否被接收者拉黑，组队闸检查邀请者是否被被邀请者拉黑。两道闸独立工作，拉黑聊天不影响组队邀请，拉黑组队不影响私聊屏蔽。黑名单的批量导入：旧号的拉黑记录在新服自动同步，跨服迁移的拉黑关系保留。

验证与监控

拉黑的操作量与解除量的日差值监控，净拉黑数的持续增长提示社交环境的恶化。

踩坑记录

拉黑的判定曾经按角色名，改名后拉黑失效，判定改为按角色唯一 ID 后稳定。黑名单的上限溢出时最旧的记录被自动挤出，被挤出的正好是最需要的，上限溢出改为拒绝新拉黑并提示清理。

上线要点

黑名单的入口从聊天面板与好友列表两处可达，入口的便利性影响使用率。拉黑的反馈文案克制：只说不再收到，不说对方被拉黑，避免挑衅升级。黑名单的批量导入与导出支持跨服迁移时保留社交的防护关系。

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