Overview
Saro's Report System bridges the gap between your Minecraft server and your staff team. It allows players to submit tickets in-game that are instantly posted to a Discord channel via webhooks, ensuring you never miss a player report or bug submission.
Key Features
🎫 In-Game Ticketing
- Simple Command: Players use
/ticket <category> <reason>to submit reports. - Smart Completion: Tab auto-completion only shows categories you've configured (e.g., "Bug", "Report", "Staff Request").
- Multi-Word Support: Categories can contain spaces (e.g., "Player Report").
💬 Discord Integration
- Rich Embeds: Tickets appear as polished embeds in Discord.
- Context: Reports automatically include the player's name, UUID, location (X/Y/Z), and dimension.
- Visuals: Uses the player's Minecraft skin head as the embed thumbnail.
⚙️ Server-Side Configuration
- No Client Needed: Players don't need to install the mod; it runs entirely on the server.
- Customizable: Configure messages, categories, permission levels, and Discord embed colors (
#HexCode) inconfig/sarosdiscordwebhook-common.toml.
Commands
| Command | Description |
|---|---|
/ticket |
Shows available categories |
/ticket <category> <reason> |
Submit a new ticket |
Examples:
/ticket Bug The bees are escaping the hive!/ticket "Player Report" Steve is griefing spawn.
Configuration
All options in config/sarosdiscordwebhook-common.toml:
| Option | Default | Description |
|---|---|---|
tickets.enabled |
true |
Enable ticket system |
tickets.categories |
Bug, Player Report, Staff Request, Other | Available categories |
tickets.discordWebhookUrl |
"" |
Discord webhook URL |
tickets.commandPermissionLevel |
0 |
Permission level (0-4) |
tickets.inputTimeoutSeconds |
120 |
Session timeout in seconds |
tickets.messageTemplate |
... | Template with placeholders |
tickets.embedColorHex |
#5865F2 |
Embed color |
📝 Template Placeholders
{player}, {uuid}, {category}, {reason}, {dimension}, {x}, {y}, {z}
Note: This wiki serves as documentation. For active discussion, please join the Discord Server.
