qStaffChat

Support me on Ko-fi

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

```yaml

--- 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 Copy Channel ID and create an application. 2. Add a Copy Channel ID and copy the token → set as `DiscordBotToken`. 3. Under *Bot → Privileged Gateway Intents*, enable Copy Channel ID, Copy Channel ID. 4. Invite the bot to your server with the `bot` scope and Copy Channel ID permission. 5. Enable Copy Channel ID in Discord, right-click the target channel → Copy Channel ID → set as `DiscordChannelId`. 6. Run `/staffchat reload` — the bot will connect immediately.