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)

1. Go to discord.com/developers/applications and create an application.
2. Add a Bot and copy the token → set as DiscordBotToken.
3. Under Bot → Privileged Gateway Intents, enable Server Members Intent, Message Content Intent.
4. Invite the bot to your server with the bot scope and Read/Send Messages permission.
5. Enable Developer Mode in Discord, right-click the target channel → Copy Channel ID → set as DiscordChannelId.
6. Run /staffchat reload — the bot will connect immediately.