SimpleReportPlugin

A simple and lightweight player report system for Spigot/Paper 1.21.x. Players can report other players with a reason, while staff/OPs can review all reports in a clean inventory GUI and decide to ban the reported player or delete the report.

All reports are stored persistently in a JSON file, so they remain available after server restarts.

---

Features

• /report: Players can report other players (including a reason)
• Anti-spam protection
  • A player can report the same target only once as long as that report still exists
  • Global 5 minute cooldown: a player can only create one new report every 5 minutes
• Staff GUI / Reports overview
  • OPs can view reports in an inventory GUI
  • Select a report by clicking the player head
  • Actions via buttons:
    • Ban (Red Wool): bans the reported player and removes the selected report
    • Delete (Barrier): deletes the selected report (no ban)
    • Close (Redstone): closes the GUI
    • Reports stay after restart

• Configuration (config.yml)

The plugin automatically generates a configuration file on the first startup. It allows you to paste a Discord Webhook URL to receive instant logs in your Discord channel whenever a report is made, with an optional toggle to ping a specific role or @everyone.

---

Commands

/report <player> <reason>

Creates a report for the given player.

Examples:

• /report Steve Fly hacks
• /report Alex Chat harassment

Rules:

• You cannot report yourself
• You cannot report the same player multiple times while the report exists
• You can only create one report every 5 minutes

---

/reports

Opens the reports GUI.

• OP only by default (default: op)
• Shows each report as a player head item including:
  • reporter
  • reason
  • timestamp

---

Staff GUI Usage

1. Run /reports
2. Click a head to select a report
   (the paper item will show Selected: <playername>)
3. Click one of the action buttons:
   • Ban (Red Wool): bans the player and removes the selected report
   • Delete (Barrier): deletes the selected report only
   • Close (Redstone): closes the GUI

---

Data Storage

• Reports are automatically saved when:
  • a report is created
  • a report is deleted
  • the server stops / plugin disables

Note: Only reports are saved. The 5-minute cooldown is currently stored in memory and resets after server restart (reports remain saved).

---

Compatibility

• Designed for Spigot/Paper 1.21.x
• Recommended: Paper for best performance
• Java: Java 21

---

Installation

1. Put the .jar into your server plugins/ folder
2. Start the server
3. The plugin will automatically create plugins/ReportPlugin/reports.json once reports exist

---

Support

If you find a bug add me on Discord Petarhrv16