ReportSystem v1.19.9

eportSystem: One of your must haves for tracking reports in-game and on Discord. Track all reports e
b91913bae17c1384027ff56cbc6bb21ffe66eec9.png
Report System
A structured, sleek reporting framework designed to bridge the gap between players and staff.

800x150.png



Overview
ReportSystem is a structured reporting framework designed to bridge the gap between players and the staff team. ReportSystem features a simple GUI, Discord webhook integration, and persistent database tracking—all without cluttering your server.

It also includes a suspicious player tracking system, giving staff a dedicated space to flag players based on shared IPs or fast rejoining. Combined with user management tools, plugin-specific punishment history records, and per-player reports, it provides staff with the best possible context you can get from a simple in-game report.
(Note: An additional reporting system for collecting video/screenshot proofs is recommended; this plugin is primarily designed for active, in-game staff.)

  • Made for: 1.17 - 26.2
  • Tested Versions: 1.17, 1.19.2, 1.21.8, 1.21.11, 26.1.2, 26.2
  • Supported Jars: Bukkit, Spigot, Paper, Pufferfish, Purpur, and Folia



✨ Key Features
  • Full GUI Report Submission - Includes reason selection, extra fields, and options for custom fields.
  • Complete Queue Management - Easily track open, high/low priority, and closed report states.
  • Live Discord Webhooks - Beautifully formatted embeds sent straight to your staff logs.
  • Suspicious Player Tracking - Separate from the main queue; flags fast rejoining and matching IPs (ignores shared local IPs like 192.168.x.x or 127.0.0.1).
  • History Viewers - Look back on player report and punishment history anytime.
  • Staff Customization - Detail GUIs featuring close-reason categorization.
  • Anti-Abuse Tools - In-game timeout and block system for users who spam or abuse /report.
  • Chat Input Capture - Cleanly captures extra details or text notes from staff.
  • Flexible Storage - Asynchronous database support utilizing MySQL and SQLite.
  • Visual & Audio Feedback - Fully customizable colors, titles, webhook appearances, and built-in GUI sound effects.



🛡️ Permissions
Code:
/report | reportsystem.report
/reports | reportsystem.reports
/suspicious | reportsystem.suspicious
/rsreload | reportsystem.reload
reportsystem.advanced | General advanced access
reportsystem.moderate | ReportSystem moderation
reportsystem.report.exempt | Exempt from reporting
reportsystem.suspicious.exempt | Exempt from suspicious flagging
reportsystem.punishment.exempt | Exempt from plugin punishments
reportsystem.alert | Alerts for reports / suspicious flags
reportsystem.bypass | Cooldown bypass if applicable
reportsystem.updates | Notifications for plugin updates



💻 Commands
CommandDescription
/reportOpens the report form GUI
/reportsOpens the staff report management GUI
/suspiciousOpens the suspicious tracking GUI
/rsreloadReloads the plugin configuration files
/rsOpens the core ReportSystem help menu
/rs alertsEnables or disables staff notifications



⚙️ Configuration (config.yml)
YAML:
# ------------------------------------------------------------------------------------
# ReportSystem Configuration
# https://modrinth.com/plugin/report_system (https://modrinth.com/project/UELBYZcj)
# Made by WhitlockLC
# ------------------------------------------------------------------------------------

# Reasons players pick when submitting a player report.
reasons:
  - "&cCheating / Hacking"
  - "&6Harassment / Toxicity"
  - "&eGriefing"
  - "&bSpamming"
  - "&dInappropriate Name / Skin"
  - "&aRule Breaking"
  - "&fExploiting Bugs"

# Reasons players pick when submitting a bug report
bug-report-reasons:
  - "&bClient / Visual Glitch"
  - "&bItem Duplication / Exploit"
  - "&bChunk / World Loading Issue"
  - "&bPlugin Malfunction"
  - "&bProgression Broken"
  - "&bEconomy / Balance Issue"
  - "&eOther"

# Staff report settings.
staff:
  # LuckPerms group names that are considered staff
  groups:
    - "staff"
    - "helper"
    - "moderator"
    - "admin"
  # Custom reasons for staff reports. Falls back to the main reasons list if empty
  report-reasons:
    - "&cAbuse of Power"
    - "&6Inappropriate Behaviour"
    - "&eIncompetence / Negligence"
    - "&bUnfair Treatment"
    - "&dBribery / Favouritism"
  # If true, the staff picker will also show offline staff members that
  # have logged in recently (uses LuckPerms user cache, may miss some offline staff)
  show-all-offline: false

# Message sent to players after they submit a report. Use & for color codes
confirmation-message: "&aYour report has been submitted!"

# Alert notification settings (for players with reportsystem.alerts permission)
alerts:
  # Prefix shown before every alert message. Use & for color codes
  prefix: "&6[ReportSystem]"

# Sounds played during GUI interactions
sounds:
  button-click: UI_BUTTON_CLICK
  cycle: ITEM_BOOK_PAGE_TURN
  submit: ENTITY_PLAYER_LEVELUP
  cancel: BLOCK_NOTE_BLOCK_BASS
  priority: BLOCK_ANVIL_USE
  delete: ENTITY_ITEM_BREAK
  open: BLOCK_CHEST_OPEN

# Suspicious player detection
suspicious:
  fast-rejoin:
    enabled: true
    times: 4
    seconds: 60
  same-ip:
    enabled: true
  # Flag players who submit an unusually high number of reports in a short window
  frequent-reports:
    enabled: true
    # Flag if a player submits this many reports
    count: 5
    # within this many seconds
    seconds: 300
  # LuckPerms group names that are exempt from ALL suspicious detection
  # Any player whose primary group (or any inherited group) is in this list
  # will never appear in /suspicious regardless of their activity
  exempt-groups:
    - "developer"
    - "owner"

# Auto-priority based on LuckPerms groups
auto-priority:
  enabled: false
  high-priority-groups:
    - "vip"
    - "premium"
  low-priority-groups:
    - "new"
    - "trial"

# Server selector in the report form
server-selector:
  enabled: false
  options:
    option-1:
      display: "&aSurvival"
    option-2:
      display: "&bCreative"
    option-3:
      display: "&cSkyblock"

# Discord webhook integration
discord-webhook:
  enabled: false
  url: ""
  color-open: "#FFFFFF"
  color-closed: "#44BB44"
  color-priority: "#FFAA00"
  color-low-priority: "#AAAAAA"
  # Color used for bug reports (when not priority/closed)
  color-bug: "#00AAFF"
  # Color used for staff reports (when not priority/closed)
  color-staff: "#FF4444"
  title: "Report #{id}"
  footer: "ReportSystem"
  show-timestamp: true
  thumbnail-enabled: true
  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
    show-server-ip: true
  labels:
    reported-player: "Reported Player"
    reporter: "Reporter"
    reason: "Reason"
    discord: "Discord Contact"
    server: "Server"
    notes: "Notes"
    status: "Status"
    priority: "Priority"
    server-ip: "Origin Server"

# Cross-server sync
sync:
  server-name: "Server-1"
  database:
    type: sqlite
    mysql:
      host: localhost
      port: 3306
      database: reportsystem
      username: root
      password: ""
      pool-size: 5
  redis:
    enabled: false
    host: localhost
    port: 6379
    password: ""
    channel: reportsystem-sync

# Server IP tagging
server-ip:
  enabled: false
  ip-override: ""
  server-names:
    "192.168.1.100": "Survival"
    "192.168.1.101": "Creative"
    "192.168.1.102": "Skyblock"
  show-in-discord: true
  label: "Origin Server"

# Timezone used for report timestamps
# 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

# Update checker settings
update-checker:
  # Set to false to disable all update notifications
  enabled: true
  # If true, online staff will be notified in-game on join
  notify-in-game: true
EULA: Free EULA
41 Views
5 Downloads
Jul 7, 2026 Published
N/A Updated
Not yet rated
3.9 MB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. Yes
Type
  1. Protection
  1. Staff
  1. Technology
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
  1. Folia
  1. Purpur
Supported versions
  1. 26.1
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
  1. 1.19
  1. 1.18
  1. 1.17
Supported languages
  1. English
Crediting original
https://modrinth.com/plugin/report_system
Creator
Struggling to cover the costs of your server? Set up your own webstore with Tebex in under 30 seconds.
Host a lag-free Minecraft or Hytale server in minutes.
Get 25% off your first order with our link.
Recommended for you
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 141 ratings
4,227 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 54 ratings
3,220 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 45 ratings
3,125 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
4.50 star(s) 72 ratings
2,819 purchases
All-in-one dungeon creator. Create unlimited, timed dungeon experiences with your own builds
4.50 star(s) 72 ratings
2,586 purchases
41 Views
5 Downloads
Jul 7, 2026 Published
N/A Updated
Not yet rated
3.9 MB File size
Open source
  1. No
DRM-free
  1. Yes
Unobfuscated
  1. Yes
Type
  1. Protection
  1. Staff
  1. Technology
Supported software
  1. Bukkit
  1. Spigot
  1. Paper
  1. Folia
  1. Purpur
Supported versions
  1. 26.1
  1. 1.21.11
  1. 1.21.8
  1. 1.21.5
  1. 1.21.4
  1. 1.21.2
  1. 1.21
  1. 1.20
  1. 1.19
  1. 1.18
  1. 1.17
Supported languages
  1. English
Crediting original
https://modrinth.com/plugin/report_system
Creator
Struggling to cover the costs of your server? Set up your own webstore with Tebex in under 30 seconds.
Host a lag-free Minecraft or Hytale server in minutes.
Get 25% off your first order with our link.
Recommended for you
#1 BuiltByBit Plugin ~ Protects your server from crash packet exploits ~ Folia Support
5.00 star(s) 141 ratings
4,227 purchases
Create items, blocks, mobs, emojis, and more with automatic resourcepack generation!
5.00 star(s) 54 ratings
3,220 purchases
Protect your server from crash/dupe/packet exploits with the ultimate security fix plugin.
5.00 star(s) 45 ratings
3,125 purchases
High Performance | Customizable | Cross-Version | GeyserMC | Folia Support
4.50 star(s) 72 ratings
2,819 purchases
All-in-one dungeon creator. Create unlimited, timed dungeon experiences with your own builds
4.50 star(s) 72 ratings
2,586 purchases
Top