员工聊天

员工聊天

一个用于你服务器员工团队的私密聊天频道。

管理

StaffChat

为你的服务器管理团队准备的私密聊天频道。 一条命令,一个权限节点,零噪音。切换到管理模式下,让下一次对话远离公共聊天——或者用 @hello 快速发送单行消息,无需离开全局频道。专为确保私密对话绝不会通过镜像公共聊天的 Discord 桥接模组泄漏而构建。

StaffChat 1.0.0 — 适用于 Minecraft 1.21.1 / Fabric。仅服务端。除 Fabric API 外无硬性依赖。LuckPerms 为可选。将其放入 mods/,给自己 OP,即可使用。


功能说明

有三种方式向管理频道发送消息,全部由单一权限 staffchat.true 控制:

  • 单独使用 /staffchat 切换“管理聊天模式”——此后你输入的每一行常规聊天都只发送给管理人员,直到你再次切换关闭。标题脉冲 + 持续显示的 ● Staff Chat Mode 动作栏提醒你正处于隐身模式,以免意外泄漏到全局聊天。
  • /staffchat <message>(或 /sc <message>)发送一次性消息,不改变你的切换状态。适合在游戏中途快速回复。
  • @<message> 快捷前缀 在普通聊天中使用——输入 @need help at spawn,消息仅路由给管理人员。前缀字符可配置,以防 @ 与你的提及语法冲突。

未处于切换模式的管理人员仍然会接收每条管理消息。切换纯粹是发送端的便利功能——它不会限制接收。

提及提醒

在任何管理消息中,输入 @<playername> 即可提醒该管理成员:

  • 其动作栏闪烁显示 ★ Mentioned by <you>
  • 播放可配置的提示音(默认:经验球拾取音效)
  • 跳过自我提及、离线 / 非管理人员的名称

音效 id、音量、音高和动作栏模板均可在配置中设置。

为隐私而构建

这是管理频道——泄漏会非常尴尬。本模组的架构确保:

  • 管理消息绝不会进入全局聊天管道。 我们在任何聊天广播发生之前于 ServerMessageEvents.ALLOW_CHAT_MESSAGE 处拦截(返回 false)。没有 /say 刷屏回退,没有向自己私语的暴露。
  • 其他 Discord 聊天桥接模组不会拾取管理消息。 诸如 Styled Chat、ServerSideUtils、simple-discord-bridge 等桥接模组会挂钩聊天广播管道。由于我们在 ALLOW 阶段拦截并以系统消息(而非聊天消息)重新投递,这些桥接模组永远不会观察到管理消息行。你的私密对话保持私密。
  • 唯一有意的 Discord 镜像为内置 webhook。 默认关闭。当你确实希望将管理消息镜像到特定的 Discord 频道时,设置 discord.enabled = true 并填入 webhook URL——此时由你控制哪个频道可以看到它。
  • webhook 通过 allowed_mentions.parse = [] 发布,因此管理员输入 @everyone 不会实际提醒 Discord 服务器。

内置 Discord webhook(可选启用)

可选。默认关闭。设置:

discord {
    enabled = true
    webhook-url = "https://discord.com/api/webhooks/.../..."
    username-format = "{sender}"
    avatar-url-format = "https://mc-heads.net/avatar/{uuid}"
    retries = 1
}

通过 Java 21 的 HttpClient 在专用单线程池上异步 POST——绝不会阻塞服务器 tick。失败最多重试 retries 次;配置错误的 webhook(4xx)会自动抑制 5 分钟,以免失效的令牌刷屏你的控制台。

LuckPerms 元数据前缀(软依赖)

如果存在 LuckPerms,每位发送者在 LuckPerms 元数据中的 [Prefix] 会自动添加到其管理聊天中的名称前。没有 LuckPerms 时,回退到基于 staffchat.rank.<id> 权限的配置映射:

prefixes {
    owner = "&c[Owner] "
    admin = "&4[Admin] "
    mod   = "&9[Mod] "
}

玩家的前缀是其持有的第一个匹配的 staffchat.rank.<id>,按声明顺序。最终回退:空白。

防御性设计

与我们其他服务器模组相同的偏执安全模式:

  • 每条消息发送时都会重新检查权限——若管理员在两条消息之间被降级,会静默从接收者列表中移除,不会产生泄漏错误。
  • 输入净化器会剥离控制字符和原始分节符,以防有人注入格式错误的 Minecraft 格式化代码;消息长度上限为 chat.max-length(默认 256);拒绝“全是格式,没有内容”的载荷。
  • 速率限制——滑动 30 秒窗口,默认每窗口 10 条消息,可配置。发送者收到“慢一点”的回复,消息在服务端被丢弃,审计日志记录速率限制事件。
  • staffchat.bypass.rate-limit 使用仅显式权限解析——OP 不会自动绕过,除非 LuckPerms 特别授予。
  • 审计日志——每次管理消息发送都会追加到 logs/staffchat-audit.log,包含 8 字符 base36 事务 id、时间戳、发送者 UUID + 名称、净化后的内容、接收者数量以及结果(DELIVERED / RATE_LIMITED / SANITIZED / DROPPED)。原子追加,适用于事件审查。

权限

节点 默认 用途
staffchat.true OP 4 回退 在管理频道中发送 + 接收
staffchat.bypass.rate-limit false(仅显式) 忽略速率限制
staffchat.admin.reload OP 3 /staffchat reload
staffchat.admin.list OP 3 /staffchat list
staffchat.rank.<id> — LuckPerms 缺失时的回退前缀层级

没有权限插件时:/op <name> 就足够——OP 4 满足 staffchat.true 回退。

使用 LuckPerms 时:lp group default permission set staffchat.true false,然后按等级授予。

命令

/staffchat              切换管理聊天模式              (staffchat.true)
/staffchat <message>    一次性发送(不改变切换状态)     (staffchat.true)
/staffchat reload       从磁盘重新加载配置             (staffchat.admin.reload)
/staffchat list         列出当前在线的管理人员         (staffchat.admin.list)
/sc                     /staffchat 切换的别名
/sc <message>           /staffchat <message> 的别名

配置

config/staffchat/config.conf 为 HOCON 格式。值得注意的配置项:

staffchat {
    chat {
        format            = "&8[&cSTAFF&8] &f{prefix}&7{sender}&8: &f{message}"
        quick-prefix      = "@"        # set to "" to disable
        max-length        = 256
        toggle-indicator  = "&c● Staff Chat Mode"
        toggle-on-title   = "&c&lStaff Chat ON"
        toggle-off-title  = "&7&lStaff Chat OFF"
    }
    mentions {
        enabled         = true
        sound-id        = "minecraft:entity.experience_orb.pickup"
        sound-volume    = 0.7
        sound-pitch     = 1.2
        actionbar-text  = "&e★ Mentioned by {sender}"
    }
    discord {
        enabled            = false
        webhook-url        = ""
        username-format    = "{sender}"
        avatar-url-format  = "https://mc-heads.net/avatar/{uuid}"
        retries            = 1
    }
    prefixes { ... }
    security {
        rate-limit-per-30s = 10
        log-to-file        = true
        log-file           = "logs/staffchat-audit.log"
        log-to-console     = false
    }
    persist-toggled-state = true
    message-locale        = "auto"
    messages {}
}

手动编辑后使用 /staffchat reload,或热重载以实时应用编辑,无需重启服务器。

国际化

内置英语。放入 config/staffchat/lang/<locale>.json 即可添加任何其他语言,无需重新构建 jar。加载器优先使用配置目录覆盖而非捆绑资源,以 en_us 作为规范回退。

要求

硬性依赖:

  • Minecraft 1.21.1
  • Fabric Loader ≥ 0.16.0
  • Fabric API
  • Java 21

捆绑在 jar 内——无需额外安装:

  • Fabric Permissions API
  • SpongePowered Configurate HOCON
  • Typesafe Config

可选软依赖:

  • LuckPerms — 用于管理消息中的 [Prefix] 元数据。

它有意不是什么

  • 不是聊天桥接模组——可选的 Discord webhook 仅镜像管理频道。它不会将全局聊天桥接到 Discord。请使用真正的聊天桥接模组来实现该功能。
  • 不是管理工具——没有 /mute、/kick、/ban。请使用原版或管理模组。
  • 不是多频道——只有一个管理频道。如果你想要 admin / mod / builder 分离频道,那已计划在 v1.1 中。
  • 不是客户端模组——仅运行于服务端,玩家无需安装任何内容。

目标用户

希望为自己的管理人员提供一种快速、可靠、与 Discord 隔离的游戏内交流方式的服务器管理员,无需启动 Slack、额外的语音频道或他们不需要的管理套件。将 jar 放入 mods/,给自己 OP,输入 /staffchat——完成。


许可证: MIT 作者: souljagger