PlayerReportPlus

PlayerReportPlus
A modern, configurable player reporting system with built-in report history and moderation tools.

PlayerReportPlus provides a clean and reliable way for players to report rule-breaking behavior while giving staff an organized system to receive, review, manage, and track reports directly from the server.

Designed for Minecraft 1.21+ through 26.x+, PlayerReportPlus focuses on simplicity, customization, and efficient staff moderation without unnecessary complexity.







✦ Features
⚑ Player Reporting
Give players an easy way to report other players using:

/report <player> <reason>

PlayerReportPlus includes configurable validation for report reasons, cooldown protection, duplicate-report prevention, self-report protection, and optional permission requirements.

Players receive a clear confirmation after successfully submitting a report.

Staff Notifications
Staff members with the configured permission can receive detailed notifications whenever a new report is submitted.

Notifications can display important information such as:

• Reporter
• Reported player
• Report reason
• Report ID
• Current status

Staff can also receive a configurable notification sound when a new report arrives.

Report History
Keep track of submitted reports with a persistent report history system.

Staff can:

• View stored reports
• Open individual reports
• Review reports
• Resolve reports
• Dismiss reports
• Navigate through report pages

Each report receives its own unique ID, making it easy for staff to reference and manage individual reports.

Report Status System
Reports can move through different moderation states:

Pending → Reviewing → Resolved / Dismissed

This gives staff a simple way to keep track of which reports still require attention and which ones have already been handled.

Persistent Storage
Reports can remain available after server restarts, allowing staff to maintain a continuous moderation history.

Old reports can also be automatically cleaned up based on a configurable retention period.

Fully Customizable
PlayerReportPlus is designed to fit your server's existing style.

Customize:

• Messages
• Prefix
• Report notifications
• Status names
• Usage messages
• History layouts
• Sounds
• Colors
• Permissions
• Cooldowns
• Report limits
• Storage settings

Supports modern MiniMessage-style colors, including hex colors.

Easy Configuration
The configuration is organized into separate sections for reporting, staff notifications, report history, statuses, messages, and commands.

This makes PlayerReportPlus easy to configure without needing to modify complicated files.

Configuration Reload
Administrators can reload the plugin configuration without restarting the server.

/prp reload

✦ Commands
Player
/report <player> <reason>

Submit a report against a player.

Staff
/reporthistory <page>

View the report history.

/reporthistory view <id>

View a specific report.

/reporthistory review <id>

Mark a report as being reviewed.

/reporthistory resolve <id>

Mark a report as resolved.

/reporthistory dismiss <id>

Dismiss a report.

Administration
/prp reload

Reload the plugin configuration.

✦ Permissions
PlayerReportPlus provides separate permissions for reporting, accessing report history, staff notifications, and administrative configuration management.

Example permissions:

playerreportplus.report
playerreportplus.staff
playerreportplus.history
admin.use

Permissions can be configured to match your server's permission setup.

✦ Placeholders
PlayerReportPlus includes useful placeholders for customizing messages and report displays, including:

%report_id%
%reporter%
%reported%
%reason%
%status%
%created%
%cooldown%
%minimum%
%maximum%
%page%
%pages%

✦ Compatibility
Minecraft: 1.21+ → 26.x+
Platform: Spigot / Paper
Configuration: YAML
Colors: MiniMessage / Hex Colors

PlayerReportPlus is built with modern server versions in mind while keeping the configuration straightforward and server-owner friendly.

✦ Why PlayerReportPlus?
PlayerReportPlus keeps player reporting simple for players and organized for staff.

Instead of reports disappearing after they are submitted, staff can receive notifications, identify reports using unique IDs, review their details, update their status, and maintain a searchable history of moderation reports.

Simple for players. Powerful for staff. Fully configurable.

Support
If you find a bug or have a suggestion, please report it in the discussion section or leave a review

i'll try to improve the plugin even more and fix every bug if there's any found with y'all help <3