AdvancedReports

AdvancedReports completely reimagines how reporting works in Minecraft. We threw out the clunky, laggy, and outdated Chest-GUIs and replaced them with beautiful, interactive Chat-Dialogs using the modern MiniMessage format.

Built with large networks in mind, AdvancedReports runs 100% asynchronously, meaning it will never cause TPS drops or lag spikes on your server, even with thousands of reports.

✨ Key Features

• 💬 Interactive Chat UI: Manage reports directly in your chat. Clickable buttons, hover-text, and clean designs replace annoying inventory menus.
• ⚡ Zero Lag & 100% Async: All database queries, player lookups, and network syncs are executed on background threads. Your server TPS will always stay at a perfect 20.0.
• 🌍 Multi-Server Ready: Seamlessly sync reports across your entire network using Redis or standard Plugin Messaging (Velocity).
• 🗄️ Database Support: Choose between SQLite (plug-and-play for single servers) or MySQL / MariaDB (for large networks).
• 👾 Discord Webhooks: Get instant notifications in your Discord! Fully customizable embeds for new reports, bug reports, and status updates.
• 🐛 Built-in Bug Tracking: Players can use /bugreport to report map glitches or bugs, optionally attaching their exact location so admins can teleport there instantly.
• 🌐 Multiple Languages Out of the Box: Native support for English, German, Spanish, and French. All fully customizable!
• 🎨 Beautiful Formatting: Full support for MiniMessage, Hex Colors, Gradients, and Custom Fonts across all messages.

🛠️ Setup & Configuration

⚠️ Requirements: Your server must run Paper 1.21.7 or higher. Older versions or Spigot/Bukkit are not supported due to modern API usage.

AdvancedReports is completely plug-and-play. Drop it into your plugins folder and you're good to go!

If you want to link multiple servers, simply open modules/multi-server.yml, set enabled: true, enter your MySQL database, and choose your preferred syncing method (REDIS or PLUGIN_MESSAGE).

💡 Velocity Network Note: If you choose PLUGIN_MESSAGE as your sync method, you must install the AdvancedReportsVelocity companion plugin on your proxy. You still need to install the main AdvancedReports plugin on all of your backend Paper servers!

📜 Commands & Permissions

Player Commands

• /report <player> - Open the dialog to report a player.
• /bugreport - Submit a bug or glitch report.
• /myreports - View the status of your previously submitted reports.

Admin Commands

• /reports - Open the interactive report list.
• /reports view <id> - View deep details of a specific report and accept/deny it.
• /bugs - Open the interactive bug report list.
• /advancedreports reload - Reload all configurations on the fly.
• /advancedreports testreport <player> - Generate a fake report for testing.

Key Permissions

• advancedreports.report - Allows players to report others. (Default: true)
• advancedreports.bugreport - Allows players to report bugs. (Default: true)
• advancedreports.myreports - Allows players to view their own reports. (Default: true)
• advancedreports.staff - Allows staff to view and manage reports.
• advancedreports.notify - Receive a ping when a new report is created.
• advancedreports.teleport - Allow teleporting to a bug report's location.
• advancedreports.cooldown.bypass - Bypass the report cooldown.
• advancedreports.admin - Access to administrative commands (like reloading the config).

🤝 Support & Issues

Need help setting up Redis? Found a bug? Join our community or open an issue!

Discord Support Server