AevorinReports

<p align="center"> <img src="https://i.postimg.cc/9RR2yP4Z/aevorin-reports-title.png" alt="AevorinReports Banner" width="200"/> </p> # Official Documentation ## Overview AevorinReports is a modern, robust reporting system designed for Minecraft servers that require structured moderation workflows. It enables players to submit reports easily while providing staff with powerful tools to review, manage, and resolve reports efficiently. The plugin is optimized for performance, supports multiple GUI styles, integrates with Discord, and scales seamlessly across single servers and networks. --- ## Region Restriction **AevorinReports** is designed to be used globally; however, please note that the plugin is **restricted and will not function** on servers located within **Israel**. This is enforced via automated IP/timezone verification. **#FreePalestine** --- ## 1. Core Features - **Interactive Admin GUI** – Review, manage, and update reports using a clean, click-based interface - **Player Report History** – Players can view their submitted reports and statuses using `/reports` - **Multiple GUI Types** – Supports both **Book GUI** and **Container (Chest) GUI** styles - **Real-Time Staff Alerts** – Instantly notify staff members when a report is submitted - **Clear Status Workflow** – Reports transition through **Pending → Resolved / Rejected** - **Custom Report Reasons** – Allows players to provide custom reasons via chat input - **MiniMessage Support** – Fully customizable messages with gradients, hover events, and formatting - **Discord Integration** – Dedicated Discord bot with embeds and real-time notifications - **Database Support** – SQLite (local) and MySQL (network-wide synchronization) - **Optimized Performance** – Asynchronous processing and intelligent caching - **Full Localization Support** – Built-in multi-language system with support for custom language packs - **PlaceholderAPI Support** – Provides report statistic placeholders documented on the (https://wiki.placeholderapi.com/users/placeholder-list/minecraft/#aevorinreports) - **bStats & FastStats Integration** – Anonymous usage statistics and advanced telemetry for development insights --- ## 2. Commands ### 2.1 Player Commands | Command | Description | Permission | | --------------------------- | -------------------------------------------- | ----------------------- | | `/report <player> ` | Submit a report against a player | `aevorinreports.report` | | `/reports` | View your submitted reports and their status | `aevorinreports.report` | **Notes:** - If no reason is provided with `/report`, a GUI will open - Custom reasons can be entered via chat ### 2.2 Staff Commands | Command | Description | Permission | | ----------------------------------- | ------------------------------------ | ----------------------- | | `/reports` | Open the Admin Report Management GUI | `aevorinreports.manage` | | `/viewreport <id>` | View detailed report information | `aevorinreports.manage` | | `/setreportstatus <id> to <status>` | Update report status | `aevorinreports.manage` | | `/ar reload` | Reload the plugin configuration | `aevorinreports.reload` | ### 2.3 Discord Bot Commands | Command | Description | | --------------- | -------------------------------------- | | `/reports` | List all active pending reports | | `/lookup <id>` | View full details of a specific report | | `/resolve <id>` | Mark a report as Resolved | | `/reject <id>` | Mark a report as Rejected | | `/pending <id>` | Mark a report as Pending | | `/help` | View the bot help menu | --- ## 3. Permissions ### 3.1 Basic Permissions | Permission | Description | Default | | ----------------------- | --------------------------------------------------- | ------- | | `aevorinreports.report` | Allows players to submit reports | `true` | | `aevorinreports.manage` | Allows staff to manage reports and access Admin GUI | `op` | | `aevorinreports.notify` | Receive notifications when a report is submitted | `op` | | `aevorinreports.reload` | Reload the configuration | `op` | ### 3.2 Wildcard Permissions | Permission | Description | | ------------------ | ------------------------------------- | | `aevorinreports.*` | Grants all AevorinReports permissions | --- ## 4. Report Workflow 1. A player submits a report using `/report` 2. Staff members receive instant notifications 3. Report is marked as **Pending** 4. Staff review the report via the Admin GUI 5. Re