Player Report

<p align="center"> <img src="" alt="PlayerReport"> </p> A modern in-game player reporting system designed for server moderation teams. Players can easily report rule violations while moderators receive powerful tools to review, filter and process reports directly in-game using intuitive GUIs. Version 4.0.0 is a complete rewrite, introducing a modern report workflow, improved moderation tools, database support, Discord integration and much more. Almost every feature, message and visual can be configured in the config! <p align="center"> <a href="https://discord.gg/y4DC2bk7Kh"> <img src="" alt="Discord" width="300"> </a> </p> <p align="center"> <img src="" alt="Features"> </p> - Modern in-game reporting system - Easy player reporting via `/report` - Optional reason GUI and confirmation system - Advanced moderation GUI for staff - Assign moderators as report handlers - Filter and sort reports directly in-game - Teleport to reported players or saved locations - Reward players for valid reports - Supports online & offline reward claiming - Discord webhook integration for reports and updates - PlaceholderAPI support for statistics and integrations - Storage support for YAML or MySQL - Search reports by player, ID, reason or handler - Notification system for staff members - Automatic cleanup for old reports - Highly configurable messages, GUIs and behavior - Lightweight and optimized for performance - Supports Folia PlayerReport was built to help staff manage reports quickly and efficiently — directly in game. Quick, how? → Reports can be reviewed and updated instantly. Efficiently, how? → Lightweight design with optimized storage. Effectively, how? → Clear moderation workflow with optional rewards. <p align="center"> <img src="" alt="GUI Preview 1"> </p> <p align="center"> <img src="" alt="GUI Preview 2"> </p> Reports are displayed inside a fully configurable GUI. Staff members can: - review reports - change report status - assign handlers - teleport to involved players (reporting and reported player) - remove reports Filtering and sorting options help moderators handle large amounts of reports efficiently. <p align="center"> <img src="" alt="Rewards"> </p> Players can optionally receive rewards when their reports are confirmed. Rewards support: - command rewards - item rewards - offline reward storage - reward claiming via `/reports claim` Due to the support of command rewards, this feature is compatible with other plugins, such as giving out vote keys as rewards or basically any other command. This allows servers to encourage players to help maintain a fair environment. <p align="center"> <img src="" alt="Commands"> </p> <details> <summary><strong>Commands</strong></summary> | Command | Permission | Description | |---|---|---| | /report <player> <reason> | playerreport.report | Create a report for a player. | | /reports | playerreport.admin | Open the moderation GUI to view and manage reports. | | /reports help | playerreport.admin | Shows all available PlayerReport commands. | | /reports search user <player> | playerreport.admin | Search reports created by or against a specific player. | | /reports search id <reportId> | playerreport.admin | Find a report by its unique ID. | | /reports search reason <text> | playerreport.admin | Search reports containing a specific reason. | | /reports search handler <player> | playerreport.admin | Show reports assigned to a specific moderator. | | /reports sethandler <reportId> <player\|none> | playerreport.admin.handler.set | Assign or remove a moderator as the handler of a report. | | /reports clear | playerreport.admin.clear | Clear outdated or deleted reports. | | /reports claim | playerreport.claim | Claim rewards for confirmed reports. | | /reports on | playerreport.admin.notify.toggle | Enable report notifications. | | /reports off | playerreport.admin.notify.toggle | Disable report notifications. | | /reports reload | playerreport.reload | Reload the plugin configuration files. | </details> <p align="center"> <img src="" alt="Permissions"> </p> <details> <summary><strong>Permissions</strong></summary> | Permission | Description | |---|---| | playerreport.* | Grants access to all PlayerReport permissions. | | playerreport.report | Allows players to create reports using /report. | | playerreport.bypass.cooldown | Bypasses the report cooldown. | | playerreport.immune | Prevents a player from being reported. | | playerreport.admin | Allows access to the moderation GUI (/reports). | | playerreport.admin.handler.set | Allows assigning or removing report handlers. | | playerreport.admin.clear | Allows clearing outdated reports using /reports clear. | | playerreport.admin.notify.toggle | Allows toggling report notifications using /reports on/off. | | playerreport.reload | Allows reloading the plugin configuration with /reports reload. | | playerreport.update.notify | Receive notifications when a plugin update is available. | | playerreport.claim | Allows players to claim rewards for successful reports. | </details> <p align="center"> <img src="" alt="config.yml"> </p> <details> <summary><strong>config.yml</strong></summary> ```yaml

=========================================================

PlayerReport - config.yml

Built for Paper 1.21.x (api-version: 1.20)

#

Color codes:

Use & for normal Minecraft colors (example: &a, &c, &7)

HEX colors in lang.yml are supported via &#RRGGBB or #RRGGBB

=========================================================

=========================================================

Reporting

Settings for creating reports

=========================================================

reporting: # If true, the reported player must currently be online # to be reported. requireOnlineTarget: false # Maximum number of open reports a single reporter # can have at the same time. maxOpenReportsPerReporter: 5 # Cooldown in seconds between creating reports. cooldownSeconds: 10 # Defines how report reasons are handled. # Available modes: # - FREETEXT = players type any reason # - PREDEFINED = players must use one of the predefined reasons # - BOTH = both systems are allowed reasonMode: FREETEXT # List of predefined reasons used when PREDEFINED or BOTH is enabled. predefinedReasons: - "Cheating" - "Bug abuse" - "Harassment" # GUI for selecting predefined report reasons. reasonGui: # Enables the reason selection GUI. enabled: false # If true, players may still enter a reason directly by command, # even when the reason GUI is enabled. allowCommandReason: true # Inventory title of the reason selection GUI. title: "&cSelect a reason for &f%target%" # Inventory size of the reason selection GUI. # Should be a valid chest size (9, 18, 27, 36, 45, 54). size: 27 filler: # If true, empty GUI slots are filled with the filler item. enabled: true # Material used for filler slots. material: GRAY_STAINED_GLASS_PANE reasonItem: # Material used for each selectable reason. material: PAPER # Display name of a reason item. name: "&a%reason%" # Lore shown on each reason item. lore: - "&7Report &f%target% &7for: &b%reason%" - "" - "&eClick to continue" # Confirmation GUI shown before the report is submitted. confirm: # Title of