# StaffChat<\/p>\n
**A private chat channel for your server’s staff team.** One command, one permission node, zero noise. Toggle into staff mode to keep the next conversation off public chat \u2014 or quick-fire a single line with `@hello` without ever leaving the global channel. Built so secret conversations **never leak** through Discord-bridge mods that mirror public chat.<\/p>\n
> **StaffChat 1.0.0** \u2014 for **Minecraft 1.21.1 \/ Fabric**. Server-side only. **No hard dependencies** beyond Fabric API. LuckPerms optional. Drop it in `mods\/`, op yourself, and it works.<\/p>\n
—<\/p>\n
## What it does<\/p>\n
Three ways to send to the staff channel, all gated by a single permission `staffchat.true`:<\/p>\n
– **`\/staffchat`** alone toggles “staff chat mode” \u2014 every regular chat line you type now goes to staff only until you toggle off. A title pulse + a persistent `\u25cf Staff Chat Mode` actionbar reminds you you’re in stealth mode so you never accidentally leak to global. Staff who *aren’t* in toggle mode still **receive** every staff message. Toggle is purely a sending convenience \u2014 it doesn’t gate reception.<\/p>\n ## Mention pings<\/p>\n Inside any staff message, drop `@ Sound id, volume, pitch, and actionbar template are all in the config.<\/p>\n ## Built for privacy<\/p>\n This is a staff channel \u2014 leaks would be embarrassing. The mod is architected so:<\/p>\n – **Staff messages NEVER reach the global chat pipeline.** We suppress at `ServerMessageEvents.ALLOW_CHAT_MESSAGE` (return false) before any chat broadcast happens. No `\/say`-spam fallback, no whispered-to-self exposure. ## Built-in Discord webhook (opt-in)<\/p>\n Optional. Off by default. Set: ## LuckPerms metadata prefixes (soft-dep)<\/p>\n If LuckPerms is present, each sender’s `[Prefix]` from LuckPerms metadata is automatically prepended to their name in staff chat. Without LuckPerms, fall back to a config-based map keyed by `staffchat.rank. “`hocon A player’s prefix is the first matching `staffchat.rank. ## Defensive design<\/p>\n Same paranoid security patterns as our other server mods:<\/p>\n – **Permission re-checked on every message send** \u2014 a staff member demoted between two messages silently drops off the recipient list with no leaking error. ## Permissions<\/p>\n | Node | Default | Purpose | Without a permissions plugin: `\/op With LuckPerms: `lp group default permission set staffchat.true false` then grant per-rank.<\/p>\n ## Commands<\/p>\n “` ## Configuration<\/p>\n `config\/staffchat\/config.conf` is HOCON. Notable knobs:<\/p>\n “`hocon Edit by hand and `\/staffchat reload`, or hot-reload to pick up edits live without bouncing the server.<\/p>\n ## i18n<\/p>\n English bundled. Drop `config\/staffchat\/lang\/ ## Requirements<\/p>\n Hard dependencies: Bundled inside the jar \u2014 no extra installs: Optional soft dependency: ## What it intentionally is *not*<\/p>\n – **Not a chat-bridge mod** \u2014 the optional Discord webhook only mirrors the staff channel. It does not bridge global chat to Discord. Use a real chat-bridge mod for that. ## Target audience<\/p>\n Server operators who want a quick, reliable, Discord-isolated way for their staff to talk in-game without spinning up Slack, a side voice channel, or a moderation suite they don’t need. Drop the jar in `mods\/`, op yourself, type `\/staffchat` \u2014 done.<\/p>\n —<\/p>\n **License:** MIT A private chat channel for your server’s staff team.<\/p>\n","protected":false},"featured_media":147865,"template":"","meta":{"_minecraft_slug":"staffchat-fabric","_minecraft_project_id":"wYn2zpCf","_minecraft_author":"souljagger","_minecraft_license":"MIT","_minecraft_downloads":16,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"staffchat-fabric.zip","_minecraft_size_bytes":1899257,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T14:22:14.215963Z","_minecraft_date_created":"2026-05-01T06:36:35.151546Z","_minecraft_date_modified":"2026-04-16T17:08:18.317002Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/staffchat-fabric","_minecraft_icon_attachment_id":147865,"_minecraft_imported_at":"2026-06-08T21:03:46+00:00","_minecraft_import_hash":"68fc420a58201385036363dcb98c2707","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,126,867,92],"mod_loader":[99],"minecraft_version":[37],"class_list":["post-147864","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-management","mod_category-social","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-1"],"yoast_head":"\n
\n– **`\/staffchat
\n– **`@
\n– Their actionbar flashes `\u2605 Mentioned by
\n– A configurable chime plays (default: experience-orb pickup)
\n– Self-mentions skipped, offline \/ non-staff names skipped<\/p>\n
\n– **Other Discord chat-bridge mods do NOT pick up staff messages.** Bridges like Styled Chat, ServerSideUtils, simple-discord-bridge etc. hook the chat-broadcast pipeline. Because we suppress at the ALLOW phase and re-deliver as **system messages** (not chat messages), those bridges never observe a staff line. Your secret conversations stay secret.
\n– **The only intended Discord mirror is the built-in webhook.** Off by default. Set `discord.enabled = true` and a webhook URL when you actually want staff mirrored to a specific Discord channel \u2014 at which point YOU control which channel sees it.
\n– The webhook posts with `allowed_mentions.parse = []` so a staff member typing `@everyone` doesn’t actually ping the Discord server.<\/p>\n
\n“`hocon
\ndiscord {
\n enabled = true
\n webhook-url = “https:\/\/discord.com\/api\/webhooks\/…\/…”
\n username-format = “{sender}”
\n avatar-url-format = “https:\/\/mc-heads.net\/avatar\/{uuid}”
\n retries = 1
\n}
\n“`
\nAsync POST via Java 21’s `HttpClient` on a dedicated single-thread pool \u2014 never blocks the server tick. Failures retried up to `retries` times; misconfigured webhooks (4xx) auto-suppress for 5 minutes so a stale token doesn’t spam your console.<\/p>\n
\nprefixes {
\n owner = “&c[Owner] ”
\n admin = “&4[Admin] ”
\n mod = “&9[Mod] ”
\n}
\n“`<\/p>\n
\n– **Input sanitizer** strips control chars and the raw section-sign so nobody injects malformed Minecraft formatting; caps message length at `chat.max-length` (default 256); rejects “all formatting, no content” payloads.
\n– **Rate limit** \u2014 sliding 30-second window, default 10 messages per window, configurable. Sender gets a “slow down” reply, message dropped server-side, audit log records the rate-limit event.
\n– **`staffchat.bypass.rate-limit`** uses explicit-only permission resolution \u2014 OPs don’t auto-bypass unless LuckPerms specifically grants it.
\n– **Audit log** \u2014 every staff send appends to `logs\/staffchat-audit.log` with an 8-char base36 transaction id, timestamp, sender UUID + name, sanitized content, recipient count, and outcome (DELIVERED \/ RATE_LIMITED \/ SANITIZED \/ DROPPED). Atomic appends, useful for incident review.<\/p>\n
\n|—|—|—|
\n| `staffchat.true` | OP 4 fallback | Send + receive in the staff channel |
\n| `staffchat.bypass.rate-limit` | **false** (explicit only) | Ignore the rate limit |
\n| `staffchat.admin.reload` | OP 3 | `\/staffchat reload` |
\n| `staffchat.admin.list` | OP 3 | `\/staffchat list` |
\n| `staffchat.rank.
\n\/staffchat Toggle staff chat mode (staffchat.true)
\n\/staffchat
\n\/staffchat reload Reload config from disk (staffchat.admin.reload)
\n\/staffchat list List currently-online staff (staffchat.admin.list)
\n\/sc Alias for \/staffchat toggle
\n\/sc
\n“`<\/p>\n
\nstaffchat {
\n chat {
\n format = “&8[&cSTAFF&8] &f{prefix}&7{sender}&8: &f{message}”
\n quick-prefix = “@” # set to “” to disable
\n max-length = 256
\n toggle-indicator = “&c\u25cf Staff Chat Mode”
\n toggle-on-title = “&c&lStaff Chat ON”
\n toggle-off-title = “&7&lStaff Chat OFF”
\n }
\n mentions {
\n enabled = true
\n sound-id = “minecraft:entity.experience_orb.pickup”
\n sound-volume = 0.7
\n sound-pitch = 1.2
\n actionbar-text = “&e\u2605 Mentioned by {sender}”
\n }
\n discord {
\n enabled = false
\n webhook-url = “”
\n username-format = “{sender}”
\n avatar-url-format = “https:\/\/mc-heads.net\/avatar\/{uuid}”
\n retries = 1
\n }
\n prefixes { … }
\n security {
\n rate-limit-per-30s = 10
\n log-to-file = true
\n log-file = “logs\/staffchat-audit.log”
\n log-to-console = false
\n }
\n persist-toggled-state = true
\n message-locale = “auto”
\n messages {}
\n}
\n“`<\/p>\n
\n– **Minecraft 1.21.1**
\n– **Fabric Loader \u2265 0.16.0**
\n– **Fabric API**
\n– **Java 21**<\/p>\n
\n– Fabric Permissions API
\n– SpongePowered Configurate HOCON
\n– Typesafe Config<\/p>\n
\n– **LuckPerms** \u2014 for `[Prefix]` metadata in staff messages.<\/p>\n
\n– **Not a moderation tool** \u2014 no \/mute, \/kick, \/ban. Use vanilla or a moderation mod.
\n– **Not multi-channel** \u2014 one staff channel. If you want admin \/ mod \/ builder split channels, that’s planned for v1.1.
\n– **Not client-side** \u2014 runs server-side only, players need nothing installed.<\/p>\n
\n**Author:** souljagger<\/p>\n","protected":false},"excerpt":{"rendered":"