# SimpleReportPlugin <\/p>\n
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.<\/p>\n
All reports are stored **persistently in a JSON file**, so they remain available after server restarts.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **\/report**: Players can report other players (including a reason)
\n– **Anti-spam protection**
\n – A player can report the same target **only once** as long as that report still exists
\n – Global **5 minute cooldown**: a player can only create one new report every 5 minutes
\n– **Staff GUI \/ Reports overview**
\n – OPs can view reports in an **inventory GUI**
\n – Select a report by clicking the **player head**
\n – Actions via buttons:
\n – **Ban** (Red Wool): bans the reported player and removes the selected report
\n – **Delete** (Barrier): deletes the selected report (no ban)
\n – **Close** (Redstone): closes the GUI
\n – Reports stay after **restart**<\/p>\n
—<\/p>\n
## Commands<\/p>\n
### `\/report **Examples:** **Rules:** —<\/p>\n ### `\/reports` – **OP only** by default (`default: op`) —<\/p>\n ## Staff GUI Usage<\/p>\n 1. Run `\/reports` —<\/p>\n ## Data Storage<\/p>\n – Reports are automatically saved when: **Note:** Only reports are saved. The 5-minute cooldown is currently stored in memory and resets after server restart (reports remain saved).<\/p>\n —<\/p>\n ## Compatibility<\/p>\n – Designed for **Spigot\/Paper 1.21.x** —<\/p>\n ## Installation<\/p>\n 1. Put the `.jar` into your server `plugins\/` folder —<\/p>\n ## Support<\/p>\n If you find a bug add me on Discord **Petarhrv16**<\/p>\n","protected":false},"excerpt":{"rendered":" ReportPlugin is a lightweight Spigot\/Paper report system that lets players report others with anti-spam limits, allows staff to review reports in a GUI to ban or delete them, and persists all reports in a JSON file across restarts.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"simplereportplugin","_minecraft_project_id":"g9wycqyW","_minecraft_author":"PrIyme","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":11,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simplereportplugin.zip","_minecraft_size_bytes":308480,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T23:03:27.021862Z","_minecraft_date_created":"2026-04-26T00:19:52.112648Z","_minecraft_date_modified":"2026-04-22T18:29:54.647020Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simplereportplugin","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-08T09:23:07+00:00","_minecraft_import_hash":"78599ddcb62620cf8bad8ed4b7160e29","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,867,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-141213","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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"],"yoast_head":"\n
\nCreates a report for the given player.<\/p>\n
\n– `\/report Steve Fly hacks`
\n– `\/report Alex Chat harassment`<\/p>\n
\n– You **cannot report yourself**
\n– You cannot report the **same player multiple times** while the report exists
\n– You can only create one report every **5 minutes**<\/p>\n
\nOpens the reports GUI.<\/p>\n
\n– Shows each report as a **player head** item including:
\n – reporter
\n – reason
\n – timestamp<\/p>\n
\n2. Click a **head** to select a report
\n (the paper item will show `Selected:
\n3. Click one of the action buttons:
\n – **Ban (Red Wool)**: bans the player and removes the selected report
\n – **Delete (Barrier)**: deletes the selected report only
\n – **Close (Redstone)**: closes the GUI<\/p>\n
\n – a report is created
\n – a report is deleted
\n – the server stops \/ plugin disables<\/p>\n
\n– Recommended: **Paper** for best performance
\n– Java: **Java 21**<\/p>\n
\n2. Start the server
\n3. The plugin will automatically create `plugins\/ReportPlugin\/reports.json` once reports exist<\/p>\n