{"id":122543,"date":"2026-06-07T07:54:55","date_gmt":"2026-06-07T04:54:55","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/"},"modified":"2026-06-07T07:54:55","modified_gmt":"2026-06-07T04:54:55","slug":"player-reports","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/","title":{"rendered":"PlayerReports"},"content":{"rendered":"

# \ud83d\udee1\ufe0f PlayerReports: Advanced Player Report Plugin<\/p>\n

![Version](https:\/\/github.com\/UG88\/PlayerReports)
\n![Platform](https:\/\/papermc.io)
\n![Java](https:\/\/www.oracle.com\/java\/)<\/p>\n

**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.<\/p>\n

—<\/p>\n

## \ud83d\udcdd Plugin Overview & Summary
\nFinding 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:
\n* **Centralized Staff Control**: A powerful dashboard for staff to manage every report across the network.
\n* **Evidence-Based Moderation**: Staff can attach URLs and proof directly to reports, ensuring fair punishments.
\n* **Network-Wide Scalability**: Built with large networks in mind, featuring MySQL sync and low-latency performance.
\n* **Seamless Integration**: Hooks natively into popular punishment plugins and PlaceholderAPI.<\/p>\n

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.<\/p>\n

—<\/p>\n

## \ud83d\ude80 Key Features<\/p>\n

* **Dual Reporting Modes**: Allow players to report via an elegant **GUI Menu** or through interactive **Clickable Chat Messages**.
\n* **Staff Command Center**: A powerful, paginated staff panel to view, claim, and process reports in real-time.
\n* **Evidence Collection**: Built-in system for staff to attach URLs or proof to reports (with persistence during the UI flow).
\n* **Tiered Alert System**: Differentiates between normal and high-priority alerts (triggered by escalation thresholds).
\n* **Automatic Cleanup**: Configurable auto-closure of old reports to keep your database clean and optimized.
\n* **Cross-Server Sync**: Support for MySQL polling ensures reports are synced across your entire network (BungeeCord\/Velocity balanced).
\n* **Punishment Integration**: Native support for **LiteBans**, **AdvancedBan**, **LibertyBans**, and more.
\n* **Safe Spectating (SIP)**: Advanced teleportation system with `\/reports !back` to return staff to their original location and gamemode automatically.
\n* **Fake Report Protection**: Identify and log malicious reporters with a dedicated fake report management system.<\/p>\n

—<\/p>\n

## \ud83d\udcdc All Commands<\/p>\n

### \ud83d\udc64 Player Commands
\n| Command | Alias | Permission | Description |
\n| :— | :— | :— | :— |
\n| `\/report ` | – | `playerreports.report` | Open the report menu for a player. |
\n| `\/reportgui` | – | `playerreports.report` | Toggle between GUI and Chat reporting modes. |<\/p>\n

### \ud83d\udc6e Staff Commands (`\/reports`)
\n| Command | Permission | Description |
\n| :— | :— | :— |
\n| `\/reports` | `playerreports.staff` | Open the main staff dashboard. |
\n| `\/reports ` | `playerreports.staff` | Open the report history for a specific player. |
\n| `\/reports !logs` | `playerreports.staff` | View the archive of closed\/resolved reports. |
\n| `\/reports !fakes` | `playerreports.staff` | View reports flagged as “Fake Reports”. |
\n| `\/reports !back` | `playerreports.tp` | Teleport back to your previous location after spectating. |
\n| `\/reports !toggle ` | `playerreports.notify` | Toggle your personal report notification alerts. |
\n| `\/reports !gui` | `playerreports.report` | Toggle your personal reporting preference (GUI\/Chat). |<\/p>\n

### \ud83d\udee0\ufe0f Administrator Commands (`\/reportsadmin`)
\n| Command | Permission | Description |
\n| :— | :— | :— |
\n| `\/reportsadmin reload [all|target]` | `playerreports.admin` | Reload config, messages, categories, or punishments. |
\n| `\/reportsadmin delete ` | `playerreports.admin` | Permanently delete a specific report from the database. |
\n| `\/reportsadmin note ` | `playerreports.admin` | Add an administrative note to a report. |
\n| `\/reportsadmin gui` | `playerreports.admin` | Toggle the **Global** GUI reporting mode for all players. |
\n| `\/reportsadmin chat` | `playerreports.admin` | Toggle the **Global** Chat reporting mode. |<\/p>\n

—<\/p>\n

## \ud83d\udd11 Permissions<\/p>\n

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

—<\/p>\n

## \ud83e\udde9 Placeholders<\/p>\n

### PlaceholderAPI (PAPI)
\n| Placeholder | Description |
\n| :— | :— |
\n| `%playerreports_open_total%` | Total number of currently open\/unresolved reports. |
\n| `%playerreports_claimed_total%` | Total number of reports currently claimed by staff. |<\/p>\n

### Internal Message Placeholders
\nUsed in `messages.yml` and punishment configurations:
\n* `{target}`: The name of the reported player.
\n* `{reporter}`: The name of the player who filed the report.
\n* `{category}`: The category\/reason chosen for the report.
\n* `{reason}`: The detailed reason given.
\n* `{id}`: The unique report ID.
\n* `{count}`: Number of reports (used in thresholds).<\/p>\n

—<\/p>\n

## \u2699\ufe0f Installation<\/p>\n

1. Place `PlayerReports.jar` into your server’s `plugins\/` folder.
\n2. Restart the server to generate default configuration files.
\n3. **(Optional but Recommended)** Configure your MySQL\/MariaDB details in `config.yml` for network syncing.
\n4. Customize your report categories in `categories.yml` and punishments in `punishments.yml`.
\n5. Reload the plugin using `\/reportsadmin reload all`.<\/p>\n

—<\/p>\n

## \ud83d\udcde Support & Links<\/p>\n

* **Documentation**: [Wiki Coming Soon]
\n* **Discord**: Join our Community<\/p>\n

—
\n*Created with \u2764\ufe0f by UG88*<\/p>\n","protected":false},"excerpt":{"rendered":"

Player Report Plugin – Evidence Logs & Staff GUI. Optimized for Staff Efficiency. The ultimate Report Player Plugin for Networks.<\/p>\n","protected":false},"featured_media":122544,"template":"","meta":{"_minecraft_slug":"player-reports","_minecraft_project_id":"P0eEkXnn","_minecraft_author":"UG88","_minecraft_license":"MIT","_minecraft_downloads":121,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"player-reports.zip","_minecraft_size_bytes":716873,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T19:10:17.794727Z","_minecraft_date_created":"2026-03-04T20:13:12.013275Z","_minecraft_date_modified":"2026-02-25T16:44:02.827596Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/player-reports","_minecraft_icon_attachment_id":122544,"_minecraft_imported_at":"2026-06-07T04:54:56+00:00","_minecraft_import_hash":"983343265f78207cb24d4cb6392f052b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,90,127,129,123],"mod_loader":[132,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-122543","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-spigot","mod_category-technology","mod_loader-paper","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\nPlayerReports - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PlayerReports - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Player Report Plugin - Evidence Logs & Staff GUI. Optimized for Staff Efficiency. The ultimate Report Player Plugin for Networks.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/player-reports\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/player-reports\\\/\",\"name\":\"PlayerReports - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/player-reports\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/player-reports\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/player-reports-icon-c3140f08f56ed2ba307d6b754edfa5efbee4aa43_96.webp\",\"datePublished\":\"2026-06-07T04:54:55+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/player-reports\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/player-reports\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/player-reports\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/player-reports-icon-c3140f08f56ed2ba307d6b754edfa5efbee4aa43_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/player-reports-icon-c3140f08f56ed2ba307d6b754edfa5efbee4aa43_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/player-reports\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"PlayerReports\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PlayerReports - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/","og_locale":"en_US","og_type":"article","og_title":"PlayerReports - Minecraft","og_description":"Player Report Plugin - Evidence Logs & Staff GUI. Optimized for Staff Efficiency. The ultimate Report Player Plugin for Networks.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/","name":"PlayerReports - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/player-reports-icon-c3140f08f56ed2ba307d6b754edfa5efbee4aa43_96.webp","datePublished":"2026-06-07T04:54:55+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/player-reports-icon-c3140f08f56ed2ba307d6b754edfa5efbee4aa43_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/player-reports-icon-c3140f08f56ed2ba307d6b754edfa5efbee4aa43_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/player-reports\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"PlayerReports"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/122543","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/122544"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=122543"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=122543"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=122543"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=122543"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}