🛡️ 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

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

• Documentation: [Wiki Coming Soon]
• Discord: Join our Community

---

Created with ❤️ by UG88