🛡️ PlayerReports: Advanced Player Report Plugin

PlayerReports is a professional, feature-rich Advanced GUI Report System 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 player report plugin or a robust report player plugin is essential for maintaining a healthy community. PlayerReports offers a complete moderation suite with:

Centralized Staff Control: A powerful dashboard for staff to manage every report across the network.
Evidence-Based Moderation: Staff can attach URLs and proof directly to reports, ensuring fair punishments.
Network-Wide Scalability: 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 advanced report system, a Minecraft reporting GUI, or a cross-server moderator tool, PlayerReports provides the most efficient workflow for staff and players alike.

🚀 Key Features

Dual Reporting Modes: Allow players to report via an elegant GUI Menu or through interactive Clickable Chat Messages.
Staff Command Center: A powerful, paginated staff panel to view, claim, and process reports in real-time.
Evidence Collection: Built-in system for staff to attach URLs or proof to reports (with persistence during the UI flow).
Tiered Alert System: Differentiates between normal and high-priority alerts (triggered by escalation thresholds).
Automatic Cleanup: Configurable auto-closure of old reports to keep your database clean and optimized.
Cross-Server Sync: Support for MySQL polling ensures reports are synced across your entire network (BungeeCord/Velocity balanced).
Punishment Integration: Native support for LiteBans, AdvancedBan, LibertyBans, and more.
Safe Spectating (SIP): 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`
`/reports !gui`	`playerreports.report`	Toggle your personal reporting preference (GUI/Chat).

🛠️ Administrator Commands (`/reportsadmin`)

Command	Permission	Description
`/reportsadmin reload [all	target]`	`playerreports.admin`
`/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

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