
员工聊天
一个用于你服务器员工团队的私密聊天频道。
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
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。