EpicReports transforms your server's reporting system with:
- Inventory-based interactive menus for reporting and case management.
- Compatibility with networks and vanish plugins.
- Advanced filtering, sorting, and control systems.
- Automated in-game and Discord notifications.
- Fully manageable GUI interface inside the game.
- Designed to be stable, scalable, and easy to use in networks environments.
- Predefined Reports GUI – Choose from preset reasons when reporting.
- All Reports / Reporters / Reporteds Menus – Dynamic views with filtering and sorting.
- Info & Data Menus – Get detailed data: location, health, IP, etc.
- Actions Menu – Run quick commands (kick, ban, custom ones…).
- Filter by state (Waiting, Processing), player (online/offline), server, etc.
- Sort by date, player name, report count, UUID, and more.
Multi-Server Support (BungeeCord + MySQL)
- Reports are synchronized across your network.
- The proxy (BungeeCord) handles report saving; Spigot/Paper servers show the data.
- Fully functional in both local and multi-server setups.
️️ Vanish Plugin Compatibility
- BungeeCord mode: supports PremiumVanish.
- Spigot mode (local): supports SuperVanish, PremiumVanish, EssentialsX, VanishNoPacket, and many more.
- Automatically hides players with EpicReports.Admin permission and server operators.
Improved Notifications
- Customizable messages, titles, and sounds per event.
- Notifies for new reports, status changes, and more.
- Discord integration via ErsDiscord (my plugin created specifically to this).
⚙️ In-Game Configuration
- Modify menus, notifications, and basic options live without restarting.
- Some settings (MySQL, Discord Token, etc.) still require editing .yml files manually.
(via ErsDiscord)
- Sends formatted embedded messages with reported/reporter data, status, and time.
- Includes dynamic variables and optional images.
- Easy setup with your own bot and selected channel.
️ Additional Features
- Full support for Java 8, 11, 16, 17, 21, and 24.
- Automatic notifications on status change (e.g., Right-click to set “Processing”).
- Report limit per player and automatic reset on restart.
- Ability to report offline players.
- Public/private comment system for staff members.
New to EpicReports?
Quick Installation:
- Download EpicReports-x.x.x.jar and drop it into your /plugins/ folder.
- If using BungeeCord mode, also drop ErsDiscord.jar in your proxy.
- Start or restart your server.
- Edit your config.yml, PredefinedReports.yml, bungee-config.yml, and reasons-control.yml.
- Use /report, /ers menu, or connect Discord (optional).
- Enjoy powerful and professional report management.
Commands
Player Commands
- /report <player> <reason>
Instantly reports a player by specifying the reason directly.
- /report <player>
Opens a menu with predefined reasons for that specific player.
- /report
Opens a list of online players → choose one → select a reason from a second menu.
️ Admin / Moderator Commands
- /epicreports
Main plugin command.
- /ers
Shortcut for /epicreports.
- /ers menu
Opens the main report management menu.
- /ers menu archiveds
Opens the menu for archived reports.
- /ers menu comments
Opens the player comment menu.
- /ers skip
Skips pending notifications when the queue is overloaded (e.g. during mass reports).
- /ers save
Saves current reports to disk.
⚠️ Only available in local mode (no MySQL). Does not work on BungeeCord.
Permissions
- EpicReports.User
Allows use of the /report command.
- EpicReports.Admin
Grants full access to admin commands and menus.
Documentation / Wiki
Need help configuring the plugin or understanding how it works?
Check out the
official GitBook wiki with full setup guides, images, configuration breakdowns, and Discord integration instructions:
https://teik.gitbook.io/epicreports/
Support & Suggestions
Found a bug? Have a cool idea to improve the plugin?
Join the
official Discord server to:
- Report bugs or plugin issues.
- Get technical support.
- Suggest new features.
- Get early access to news and updates.
️
https://discord.gg/XfQZuBJu8n