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.