Discord Velocity

# Discord Velocity A (https://papermc.io/software/velocity) plugin that bridges the proxy with a Discord server: player event relay, bidirectional chat, console log streaming, command execution from Discord, and playtime statistics. ## Features - **Bidirectional chat channel**: player messages go to Discord; Discord messages reach all players on the proxy. Player display includes their LuckPerms prefix/suffix (if installed). - **Player events**: join / leave, server switch, executed commands (optional). - **Proxy state messages**: startup and shutdown. - **Console channel**: streams all Velocity logs (batched ~1.5 s to avoid rate limits). Plain messages in the channel are executed as proxy console commands with ✅ / ❌ reactions. - **ANSI escape stripping** from logs before sending. - **Presence bot**: single status, list rotation with interval, or schedule-based (`HH:mm`). Activity types: `PLAYING / LISTENING / WATCHING / STREAMING / COMPETING / CUSTOM`. Supports `%online%` / `%max%`. - **Online status** (`ONLINE / IDLE / DND / INVISIBLE`): automatic by player count or manual; each rotation entry can override it. - **Slash command `/commands`** — lists all proxy commands (console channel only). - **Slash command `/players`** — lists online players per server; supports server autocomplete. - **Slash command `/time`** — playtime per server for a player with optional period filter (requires Statify). - **`/discord-velocity` (`/dv`)** in Velocity: `info` and `reload` without restarting. - **Versioned YAML configs**: on version mismatch the old file is backed up and a fresh one is created. ## Requirements - Java **21+** - Gradle **8.10** - Velocity **3.5.0+** - Discord application → Bot with **MESSAGE CONTENT INTENT** and **SERVER MEMBERS INTENT** enabled - Enable **Developer Mode** in Discord (Settings → Advanced) to copy channel / guild IDs - (https://luckperms.net/) *(optional)* — prefix/suffix display in chat - (statify-paper-1.0.0.jar) + MySQL/MariaDB *(optional)* — `/time` command ## Installation 1. Download or build `discord-velocity-<version>.jar`. 2. Place it in Velocity's `plugins/` directory. 3. Start the proxy — `plugins/discord-velocity/config.yml` and `messages.yml` are created. 4. Fill in `config.yml`: - `discord.token` — bot token - `discord.guild-id` — guild ID (recommended; otherwise slash commands take up to 1 h to appear globally) - `discord.chat-channel-id`, `discord.console-channel-id` — channel IDs - `statify.*` — DB credentials and server list *(only needed for `/time`)* 5. Restart the proxy. ## Build from source ```bash gradle wrapper --gradle-version 8.10 ./gradlew clean shadowJar ``` Output: `build/libs/discord-velocity-<version>.jar` (fat-jar with JDA, SnakeYAML, MariaDB JDBC shaded). ## Commands ### Velocity | Command | Description | | ----------------------------- | --------------------------------------------------------- | | `/discord-velocity info` | Plugin version, bot status, channels, current presence. | | `/discord-velocity reload` | Reload `config.yml` and `messages.yml` without restart. | | `/dv ...` | Alias. | - From the proxy console or the Discord console channel — no permission required. - From an in-game server — requires **`discordvelocity.admin`** (LuckPerms: `lp user <name> permission set discordvelocity.admin true`). - `reload` applies all `config.yml` changes except `discord.*` and `console.flush-interval-ms` (a `` is emitted for those). ### Discord slash commands | Command | Where | Description | | ------------ | -------------- | ------------------------------------------------------------------------ | | `/commands` | console channel | Lists all proxy commands (ephemeral reply). | | `/players` | any channel | Online players per server; optional `server` parameter with autocomplete.| | `/time` | any channel | Playtime per server for a player. Requires `statify.enabled: true`. | Any plain message in the console channel is executed as a proxy console command. The `/` prefix is optional. #### `/players` parameters - `server` *(optional)* — filter to a single server; autocompletes from Velocity's registered servers. #### `/time` parameters - `player` — player nickname (required, case-insensitive). - `period` — `all` *(default)*, `day`, `week` (7 days), `month` (30 days), `year`, `custom`. - `from`, `to` — range for `period=custom`, format `DD.MM.YYYY` or `DD.MM.YY`. ## Configuration ### `config.yml` ```yaml config-version: "0.2.0" # set at build time — do not edit discord: token: "" guild-id: "" chat-channel-id: "" console-channel-id: "" chat: mc-to-discord: true # forward player cha