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

1. Download EasyReport.jar and drop it into your /plugins folder.
2. Restart your server to generate the configuration files.
3. Configure config.yml: Add your Discord Webhook URL.
4. (Optional) Enable AI: Set ai-settings.enabled to true and provide your OpenAI or Gemini API key to block spam reports automatically.
5. Customize offenses.yml: Tweak the punishment commands and durations to fit your server's rules.
6. 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)

---