Saros Report System

 Bring a fast, configurable ticket system to your Minecraft servers. Players file tickets in-game with a single command, you receive rich Discord notifications instantly. --- ### Highlights - In‑game tickets with a simple command: `/ticket ` - Multi‑word categories supported (e.g., "Staff Request", "Player Report") - Smart tab completion that suggests only your configured categories - Discord webhook integration using rich embeds - Configurable embed color (hex) - Player head/avatar shown in the embed - Clean, readable layout using your message template - Fully server‑side configuration (common config); no client required - Customizable user‑facing messages (success/help/errors) with placeholders ---  - Ticket command - `/ticket ` - Works with multi‑word categories - Bare `/ticket` shows a configurable help/usage message - Discord embeds - Ticket is posted to a Discord channel via webhook - Color is configurable (hex, e.g., `#5865F2`) - The player's Minecraft head is used as avatar and embed thumbnail - All placeholders from your template are preserved - Server‑side config only - Everything is configured from the server's common config (no client dependency) - All players see the same messages no matter their client language - Clean admin UX - Tab completion shows only categories from your config - Invalid categories or missing reasons return clear, configurable errors ---  - Base command: `/ticket` - Usage: `/ticket ` - Examples: - `/ticket Bug Bees are escaping the hive enclosure` - `/ticket Staff Request Please review my claim` - `/ticket Player Report Steve griefed my base at spawn` Notes - Multi‑word categories are parsed correctly; the remainder becomes the reason - Suggestions show only configured categories ---  All options live in `config/sarosdiscordwebhook-common.toml`. Key settings: - Core - `tickets.enabled` — enable/disable the system - `tickets.categories` — list of categories (strings). Supports multi‑word entries - `tickets.discordWebhookUrl` — your Discord webhook URL - `tickets.commandPermissionLevel` — required vanilla permission (0–4; 0 = everyone) - `tickets.messageTemplate` — text used as the embed description - `tickets.embedColorHex` — embed color (e.g., `#5865F2`) - Advanced - `tickets.inputTimeoutSeconds` — session timeout for future multi‑step flows - `tickets.hideReasonInChat` — for future chat‑capture flow (not used in default one‑line command) - Messages (all server‑side; placeholders are supported where shown) - `tickets.messages.successSubmitted` — shown on success - Placeholders: `{category}`, `{reason}` - `tickets.messages.errorInvalidCategory` — invalid category - `tickets.messages.errorMissingReason` — reason missing - `tickets.messages.errorWebhookNotConfigured` — webhook missing - `tickets.messages.errorOnlyPlayers` — console/non‑player usage - `tickets.messages.usageHelp` — displayed on bare `/ticket` - Placeholders: `{categories}` (comma‑separated list) - `tickets.messages.errorNoCategories` — if category list is empty - `tickets.messages.errorSendFailed` — Discord post failed Placeholders available in `tickets.messageTemplate` (used inside the Discord embed): - `{player}`, `{uuid}`, `{category}`, `{reason}`, `{dimension}`, `{x}`, `{y}`, `{z}` ---  ## FAQ & Tips - Nothing posts to Discord - Ensure `tickets.discordWebhookUrl` is set and valid - Check `tickets.enabled = true` - Players can't use `/ticket` - Lower `tickets.commandPermissionLevel` (0 lets everyone use it) - I want a different embed look - Customize `tickets.messageTemplate` and `tickets.embedColorHex` - My categories have spaces - Supported! The command matches the longest configured category at the start of the input --- [](https://server.sarocesch.de/refersaro.php) **Project Support & Usage** **Hosting:** For the best performance, I recommend using BisectHosting linked in the banner. **Modpacks:** You are free to include my work in any modpack. Please ensure proper credit is given by providing a link to this project page.