Report list

🚨 ReportList

ReportList is a lightweight, easy-to-use, and highly efficient player reporting system designed for Minecraft server administrators. It allows players to report rule-breakers easily, while providing staff with a clean, interactive Chest GUI to review, accept, or decline those reports.

Fully optimized for Paper and Purpur (1.21+).

✨ Features

• Interactive Admin GUI: Review all active reports in a beautifully formatted chest interface.
• Live Verdict System: Staff can take immediate action. Simply Left-Click a report to Accept it (found guilty), or Right-Click to Decline it (found innocent). Both the staff and the reporter receive automated custom notifications.
• 100% Configurable & Localized: Every single prefix, chat message, and GUI text is fully customizable in the messages.yml file.
• Modern Formatting Support: Fully supports Adventure API MiniMessage tags, HEX colors (<#ff00ea>), gradients (<gradient:red:gold>), and legacy formatting codes (&a, &l).
• Smart Spam Protection: Includes a customizable cooldown system to prevent players from spamming reports, plus built-in checks to prevent self-reporting and offline-player reporting.
• Asynchronous Update Checker: The plugin checks for new versions without lagging the server. Admins receive a clickable notification in the chat if a new version is available on Modrinth!
• Plug & Play: No complicated setup required. Drop it into your plugins folder and you are ready to go.

⌨️ Commands

• /report <player> <reason> — Submit a report against a specific player.
• /report check — Opens the Report GUI for administrators to review submitted reports.
• /report reload — Reloads config.yml and messages.yml without restarting the server.

🔐 Permissions

Manage these permission nodes using a plugin like LuckPerms:

• reportlist.use
  • Allows a player to submit reports. (Default: true)
• reportlist.admin
  • Grants access to the /report check command, GUI interactions, and staff alerts. (Default: op)
• reportlist.reload
  • Grants access to the /report reload command. (Default: op)

⚙️ Configuration

config.yml

# ==========================================================
#   REPORT LIST - CONFIGURATION
# ==========================================================

# Set to true to check for updates on startup
check-update: true