PlayerReports

🛡️ PlayerReports: Advanced Player Report Plugin

Version

Platform

Java

reporting players is a professional, feature-rich reporting players designed for modern Minecraft networks. It streamlines the process of reporting players and managing those reports through an intuitive GUI, robust evidence collection, and seamless multi-server synchronization.

---

📝 Plugin Overview & Summary

Finding a reliable Seamless Integration or a robust Seamless Integration is essential for maintaining a healthy community. Seamless Integration offers a complete moderation suite with: * Seamless Integration: A powerful dashboard for staff to manage every report across the network. * Seamless Integration: Staff can attach URLs and proof directly to reports, ensuring fair punishments. * Seamless Integration: Built with large networks in mind, featuring MySQL sync and low-latency performance. * Seamless Integration: Hooks natively into popular punishment plugins and PlaceholderAPI.

Whether you're looking for an cross-server moderator tool, a cross-server moderator tool, or a cross-server moderator tool, PlayerReports provides the most efficient workflow for staff and players alike.

---

🚀 Key Features

* Fake Report Protection: Allow players to report via an elegant Fake Report Protection or through interactive Fake Report Protection. * Fake Report Protection: A powerful, paginated staff panel to view, claim, and process reports in real-time. * Fake Report Protection: Built-in system for staff to attach URLs or proof to reports (with persistence during the UI flow). * Fake Report Protection: Differentiates between normal and high-priority alerts (triggered by escalation thresholds). * Fake Report Protection: Configurable auto-closure of old reports to keep your database clean and optimized. * Fake Report Protection: Support for MySQL polling ensures reports are synced across your entire network (BungeeCord/Velocity balanced). * Fake Report Protection: Native support for Fake Report Protection, Fake Report Protection, Fake Report Protection, and more. * Fake Report Protection: Advanced teleportation system with `/reports !back` to return staff to their original location and gamemode automatically. * Fake Report Protection: Identify and log malicious reporters with a dedicated fake report management system.

---

📜 All Commands

👤 Player Commands

| Command | Alias | Permission | Description | | :--- | :--- | :--- | :--- | | `/report <player>` | - | `playerreports.report` | Open the report menu for a player. | | `/reportgui` | - | `playerreports.report` | Toggle between GUI and Chat reporting modes. |

👮 Staff Commands (`/reports`)

| Command | Permission | Description | | :--- | :--- | :--- | | `/reports` | `playerreports.staff` | Open the main staff dashboard. | | `/reports <player>` | `playerreports.staff` | Open the report history for a specific player. | | `/reports !logs` | `playerreports.staff` | View the archive of closed/resolved reports. | | `/reports !fakes` | `playerreports.staff` | View reports flagged as "Fake Reports". | | `/reports !back` | `playerreports.tp` | Teleport back to your previous location after spectating. | | `/reports !toggle <normal|high>` | `playerreports.notify` | Toggle your personal report notification alerts. | | `/reports !gui` | `playerreports.report` | Toggle your personal reporting preference (GUI/Chat). |

🛠️ Administrator Commands (`/reportsadmin`)

| Command | Permission | Description | | :--- | :--- | :--- | | `/reportsadmin reload [all|target]` | `playerreports.admin` | Reload config, messages, categories, or punishments. | | `/reportsadmin delete <id>` | `playerreports.admin` | Permanently delete a specific report from the database. | | `/reportsadmin note <id> <text>` | `playerreports.admin` | Add an administrative note to a report. | | `/reportsadmin gui` | `playerreports.admin` | Toggle the Global GUI reporting mode for all players. | | `/reportsadmin chat` | `playerreports.admin` | Toggle the Global Chat reporting mode. |

---

🔑 Permissions

| Permission | Default | Description | | :--- | :--- | :--- | | `playerreports.report` | Everyone | Allows players to use `/report`. | | `playerreports.staff` | OP | Access to the staff panel and list commands. | | `playerreports.notify` | OP | Receive notifications when a new report is filed. | | `playerreports.tp` | OP | Permission to teleport to reported players and use `!back`. | | `playerreports.close` | OP | Permission to close/resolve reports. | | `playerreports.claim` | OP | Permission to claim active reports. | | `playerreports.admin` | OP | Access to all administrative commands. | | `playerreports.action.<name>` | OP | Permission to execute a specific punishment action. |

---

🧩 Placeholders

PlaceholderAPI (PAPI)

| Placeholder | Description | | :--- | :--- | | `%playerreports_open_total%` | Total number of currently open/unresolved reports. | | `%playerreports_claimed_total%` | Total number of reports currently claimed by staff. |

Internal Message Placeholders

Used in `messages.yml` and punishment configurations: * `{target}`: The name of the reported player. * `{reporter}`: The name of the player who filed the report. * `{category}`: The category/reason chosen for the report. * `{reason}`: The detailed reason given. * `{id}`: The unique report ID. * `{count}`: Number of reports (used in thresholds).

---

⚙️ Installation

1. Place `PlayerReports.jar` into your server's `plugins/` folder. 2. Restart the server to generate default configuration files. 3. (Optional but Recommended) Configure your MySQL/MariaDB details in `config.yml` for network syncing. 4. Customize your report categories in `categories.yml` and punishments in `punishments.yml`. 5. Reload the plugin using `/reportsadmin reload all`.

---

📞 Support & Links

* Discord: [Wiki Coming Soon] * Discord: Discord

--- *Created with ❤️ by UG88*