qStaffChat
A lightweight Paper plugin that gives your staff team a private in-game chat channel with optional two-way Discord sync — all through a single bot token.
Features
/sc <message>— private staff-only chat channel- Two-way Discord sync via a Discord bot (read and write in one setup)
- LuckPerms prefix support in message formatting
- PlaceholderAPI support for advanced placeholders
- Hex (
#RRGGBB) and legacy (&a,&c, …) color codes in all formats - Fully configurable message formats and permissions
/staffchat reload— reload config without restarting the server- Works in Minecraft-only mode if Discord is not configured
Requirements
| Dependency | Required |
|---|---|
| LuckPerms | Yes |
| PlaceholderAPI | Yes |
Commands & Permissions
| Command | Description | Permission | Default |
|---|---|---|---|
/sc <message> |
Send a message to staff chat | staffchat.use |
op |
/staffchat reload |
Reload the configuration | staffchat.reload |
op |
Configuration
# --- Discord Bot (optional) ---
# Leave both values empty to run in Minecraft-only mode.
DiscordBotToken: "" # Bot token from Discord Developer Portal
DiscordChannelId: "" # ID of the channel to relay messages to/from
# --- Message Formats ---
# Supports color codes:
# Legacy: &a, &b, &c, &6, &l (bold), &o (italic), etc.
# Hex: #FF0000, #00FF00, #1E90FF, etc. (1.16+ only)
formatMinecraftMessage: "StaffChat » %luckperms_prefix% %playerName% » %message%"
formatDiscordMessage: "StaffChat » [Discord] %playerName% » %message%"
formatMinecraftToDiscord: "%playerName% » %message%"
# --- Permissions ---
usagePerm: "staffchat.use"
reloadPerm: "staffchat.reload"
Available placeholders
| Placeholder | Description |
|---|---|
%playerName% |
In-game name of the sender |
%message% |
Message content |
%luckperms_prefix% |
LuckPerms prefix of the sender |
Discord Setup (optional)
- Go to discord.com/developers/applications and create an application.
- Add a Bot and copy the token → set as
DiscordBotToken. - Under Bot → Privileged Gateway Intents, enable Server Members Intent, Message Content Intent.
- Invite the bot to your server with the
botscope and Read/Send Messages permission. - Enable Developer Mode in Discord, right-click the target channel → Copy Channel ID → set as
DiscordChannelId. - Run
/staffchat reload— the bot will connect immediately.
