Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
Report System
ReportSystem is a structured reporting framework designed to bridge the gap between players and the staff team. ReportSystem has a simple GUI, Discord webhook integration, and persistent database tracking. ReportSystem makes a simple reporting process all without cluttering your server.
ReportSystem also includes a suspicious player tracking system, giving staff a dedicated space to flag players based on same IP's or fast rejoining. Combined with user management tools, punishment history records (ReportSystem punishments. Not any third party punishment plugins), and per-player reports. This means it provides staff with the best possible context you can get from a in game simple report (another reporting system for proofs is recommended, this plugin is mostly for in game active staff.)
Key Features
- Full GUI report submission with reason selection and extra fields (and options for custom fields)
- Full report management. Open, high/low prioritys, and closed states.
- Live Discord webhook embeds
- Suspicious player tracking system separate from the report queue
- Player report and punishment history viewers
- Staff tools like the report detail GUI with close reason categorization
- Timeout system for users who abuse /report
- Chat input capture for extra detail or note entry
- MySQL and SQLite storage with async database
- Configurable colors, titles, webhook appearance, and confirmation messages
- Sound and visual feedback throughout all GUI interactions
Commands
| Command | Description |
|---|---|
| /report | Opens the report form GUI |
| /reports | Opens the staff report management GUI |
| /suspicious | Opens the suspicious tracking GUI |
| /rsreload | Reloads plugin config |
config.yml
# Timezone for report timestamps.
# Use full zone IDs: America/New_York, America/Chicago, America/Denver,
# America/Los_Angeles, Europe/London, Europe/Paris, Asia/Tokyo, UTC, etc.
timezone: America/New_York
# Message sent to the player after a report is submitted.
# Use & for color codes.
confirmation-message: "&aYour report has been submitted!"
# Discord webhook integration.
# A message is posted to this webhook every time a report is submitted.
# The message is automatically edited whenever the report is updated or closed.
discord-webhook:
enabled: false
url: ""
# Embed colors (hex, e.g. #FF4444)
# White (#FFFFFF) is the default ā it looks clean and neutral in Discord.
color-open: "#FFFFFF"
color-closed: "#44BB44"
color-priority: "#FFAA00"
color-low-priority: "#AAAAAA"
# Embed title ā use {id} for the report ID
title: "Report #{id}"
# Footer text (leave blank to hide)
footer: "ReportSystem"
# Show an ISO-8601 timestamp in the embed footer
show-timestamp: true
# Show the reported player's Minecraft head as a thumbnail in the embed
thumbnail-enabled: true
# Toggle individual embed fields on or off
fields:
show-reported-player: true
show-reporter: true
show-reason: true
show-discord: true
show-server: false
show-notes: true
show-status: true
show-priority: true
# Custom display labels for each field
labels:
reported-player: "Reported Player"
reporter: "Reporter"
reason: "Reason"
discord: "Discord Contact"
server: "Server"
notes: "Notes"
status: "Status"
priority: "Priority"
# Automatic priority assignment based on LuckPerms groups.
# Disabled by default. Enable and set group names to activate.
# high-priority-groups: players in these groups will have their reports auto-marked as High Priority.
# low-priority-groups: players in these groups will have their reports auto-marked as Low Priority.
# If a player is in both, high priority takes precedence.
auto-priority:
enabled: false
high-priority-groups:
- "vip"
- "premium"
low-priority-groups:
- "new"
- "trial"
# Reasons players can select when submitting a report.
# Use & for color codes. These also appear as filter options in /reports.
reasons:
- "&cCheating / Hacking"
- "&6Harassment / Toxicity"
- "&eGriefing"
- "&bSpamming"
- "&dInappropriate Name / Skin"
- "&aRule Breaking"
- "&fExploiting Bugs"
# Server selector shown in the report form.
# Set enabled: true to allow reporters to specify which server the incident occurred on.
server-selector:
enabled: false
options:
option-1:
display: "&aSurvival"
option-2:
display: "&bCreative"
option-3:
display: "&cSkyblock"
# Suspicious player detection settings.
suspicious:
fast-rejoin:
enabled: true
# Flag a player if they rejoin this many times...
times: 4
# ...within this many seconds.
seconds: 60
same-ip:
enabled: true
# Sounds played on various GUI actions.
# Use Minecraft sound names (e.g. UI_BUTTON_CLICK, ENTITY_PLAYER_LEVELUP).
# You can use any valid MC sound key. Set to '' to disable a sound.
sounds:
# Played when clicking a standard button
button-click: UI_BUTTON_CLICK
# Played when cycling through options (reason slider, sort mode, etc.)
cycle: ITEM_BOOK_PAGE_TURN
# Played when a report is successfully submitted
submit: ENTITY_PLAYER_LEVELUP
# Played when cancelling or going back
cancel: BLOCK_NOTE_BLOCK_BASS
# Played when toggling priority
priority: BLOCK_ANVIL_USE
# Played when deleting a report or dismissing a suspicious player
delete: ENTITY_ITEM_BREAK
# Played when opening a GUI via command
open: BLOCK_CHEST_OPEN


