EasyReport v2.0
The Ultimate Reporting Solution
EasyReport has been updated! Version 2.0 transforms player reporting from a simple task into a powerful moderation workflow. With integrated AI validation, a robust punishment system, and persistent database storage, EasyReport is now the only tool you need to keep your server clean and your staff efficient.
What's New in v2.0?
- AI-Powered Validation: Automatically filter out spam, trolls, and nonsense reports using OpenAI or Gemini. Save your staff's time for real issues!
- Full Punishment System: Warn, Kick, Mute, and Ban players directly from the report GUI. Punishments scale automatically based on offense history (e.g., 1st offense = 1h mute, 2nd = 1d mute).
- Database Storage: All reports and player offense history are now saved to a local SQLite database. No more lost data on restarts!
- Modern UI & UX: A completely redesigned, aesthetically pleasing GUI.
- Developer API: A comprehensive API and custom events allow other plugins to hook into the reporting workflow.
Key Features
- Smart Reporting: Players use
/report <player> <reason> to file reports instantly. The AI (optional) checks the validity before alerting staff.
- Staff GUI: Use
/reports to view, manage, and teleport to active reports. Click to open the Punishment Menu and take immediate action.
- Discord Integration: Sends informative, compact embeds to your Discord channel with copyable names and detailed info.
- Customizable Offenses: Configure your own punishment commands and scaling durations in
offenses.yml.
- Instant Alerts: Staff get notified in-game with a clean, gradient-colored message when a valid report comes in.
Installation
- Download
EasyReport.jar and drop it into your /plugins folder.
- Restart your server to generate the configuration files.
- Configure
config.yml: Add your Discord Webhook URL.
- (Optional) Enable AI: Set
ai-settings.enabled to true and provide your OpenAI or Gemini API key to block spam reports automatically.
- Customize
offenses.yml: Tweak the punishment commands and durations to fit your server's rules.
- Run
/reportadmin reload and you're done!
Commands & Permissions
Player Commands
/report <player> <reason>
- Description: Report a player for a violation.
- Permission:
easyreport.report (Default: true)
Staff Commands
/reports [list|clear|teleport|info]
- Description: Manage active reports and open the punishment GUI.
- Permission:
easyreport.staff (Default: op)
Admin Commands
/reportadmin <reload|version|help>
- Description: Manage the plugin configuration.
- Permission:
easyreport.admin (Default: op)
