ReportSystem — Advanced Report & Replay Plugin
The most comprehensive report management system with in-game replay recording, CS:GO-style Overwatch, and anti-cheat integration.
Spigot / Paper • BungeeCord • Velocity • 1.21+
What is ReportSystem?
ReportSystem is an all-in-one moderation toolkit that goes far beyond simple player reports. When a report is created, the plugin automatically records the suspected player for 45 seconds (configurable), capturing every movement, block change, combat action, and nearby player interaction. Staff can then watch the replay in-game as a spectator — like watching a movie inside Minecraft — with full playback controls (pause, rewind, speed up, slow down).
With the built-in Overwatch system (inspired by CS:GO), trusted community members can review reports and vote on verdicts, reducing the workload on your staff team.
Key Features
- Full Replay System — Automatically records reported players with 45+ event listeners capturing movement, combat, blocks, items, chat, explosions, vehicles, and more.
- CS:GO-Style Overwatch — Community review system with rankings (Bronze > Diamond), XP rewards, leaderboards, and NPC queues.
- Anti-Cheat Integration — Native hooks for Polar, Vulcan, and GrimAC. Auto-record and auto-report when cheating is detected.
- Network Support — Full BungeeCord & Velocity proxy support with MySQL. Cross-server reports and notifications.
- Discord Webhooks — Rich embed notifications with interactive buttons for new reports, closures, and punishments.
- Fully Customizable GUIs — 15 separate GUI config files. Every item, slot, lore line, and color is editable.
- Multi-Language — Ships with English and Turkish. Easily add your own language file.
- Trust Level System — Account standing with half-life point decay. Old violations naturally lose impact over time.
- Smart Notifications — Sound, title, action bar, and Hypixel-style reporter feedback when action is taken.
- PlaceholderAPI Support — Expose report stats, trust levels, and Overwatch rankings in scoreboards, tab lists, etc.
- bStats Metrics — Anonymous usage statistics.
Replay System — 45+ Event Listeners
The replay system is not a simple position recorder. It captures everything:
- Player movement, rotation, sneaking, sprinting, swimming
- Combat actions — sword swing, bow shots, damage indicators
- Block break/place with full block state data
- Equipment & inventory changes in real-time
- Nearby player tracking (other players appear as NPCs in the replay)
- Entity interactions — fishing, leash, vehicles, breeding
- Explosions, fire spread, redstone, falling blocks
- Potion effects, health changes, game mode switches
- Chat messages, signs, anvils, enchanting, brewing
- Portal usage, bed interactions, book edits
- Weather changes, sound effects, note blocks
- ...and much more
Playback Controls:
- Play / Pause / Fast Forward (2x, 4x, 8x)
- Rewind and jump to any point in the timeline
- Night Vision toggle & NPC Glow toggle
- Replay info panel with progress bar
- Web Replay — export recordings to browser-viewable 3D format via mcraft.fun
Overwatch System
Inspired by CS:GO's Overwatch, this system lets trusted players review reports and vote on verdicts without needing staff permissions.
- NPC Queue — Place an Overwatch NPC in your lobby. Players right-click to receive a case.
- Verdict Voting — Reviewers watch the replay and vote: Guilty, Innocent, or Skip.
- Consensus System — Configurable threshold (e.g., 70% guilty votes = consensus reached).
- XP & Ranking — Earn XP for reviews. Climb from Bronze to Silver to Gold to Diamond.
- Leaderboards — Top reviewers with stats, accuracy, and rank.
- Reward Commands — Execute custom commands on review completion, level up, or rank up.
- Hologram Stats — NPC holograms display live queue count and reviewer statistics.
Anti-Cheat Integration
ReportSystem hooks directly into popular anti-cheat plugins using a suspicion scoring system:
- Polar Anti-Cheat — Cloud ML detections (KillAura, AutoClicker) give high scores. Movement mitigations give low scores.
- Vulcan Anti-Cheat — KillAura flags = +0.40, AutoClicker = +0.35, movement checks = +0.10-0.15.
- GrimAC — Free & open source. Strong at movement, reach, and scaffold detection.
When the suspicion score exceeds the configurable threshold, the plugin automatically starts recording, creates a report, and adds it to the Overwatch queue — all without staff intervention. Score decay (50% every 60 seconds) filters temporary lag spikes and false positives.
Code:
/report <player> [reason] — Report a player (opens GUI)
/reports [page] — View reports list
/reportsystem reload — Reload configuration
/reportsystem stats — View plugin statistics
/reportsystem info — Plugin information
/overwatch — Open Overwatch menu
/overwatch stats — View your Overwatch stats
/overwatch leaderboard — Top reviewers
/overwatch npc create — Create Overwatch NPC
/overwatch addqueue <id> — Add report to Overwatch queue
Code:
reportsystem.* — All permissions
reportsystem.report — Create reports (default: true)
reportsystem.view — View own reports (default: true)
reportsystem.view.all — View all reports
reportsystem.manage — Accept/reject reports
reportsystem.punish — Punish players (ban, mute, kick, warn)
reportsystem.delete — Delete reports
reportsystem.notify — Receive staff notifications
reportsystem.admin — Admin commands (reload, stats)
reportsystem.cooldown.bypass — Bypass report cooldown
reportsystem.exempt — Cannot be reported
reportsystem.overwatch — Use Overwatch system
reportsystem.overwatch.admin — Manage Overwatch NPCs & queueConfiguration
Everything is configurable. The plugin ships with 20+ config files:
- config.yml — Main settings (database, replay, notifications, anti-cheat, webhooks, performance)
- messages_en.yml / messages_tr.yml — Full language files with 200+ translatable messages
- 15 GUI config files — Every menu is fully customizable (items, slots, lore, materials, colors)
Database: SQLite (default, zero setup) or MySQL (for networks).
Auto-Update: Config files automatically update with new keys while preserving your existing settings.
Compatibility
- Minecraft: 1.21+
- Server: Spigot / Paper
- Proxy: BungeeCord / Velocity
- Java: 21+
- Required: PacketEvents
- Optional: PlaceholderAPI, Polar, Vulcan, GrimAC
What's Included
- ReportSystem-Spigot.jar (main plugin)
- ReportSystem-BungeeCord.jar (proxy module for BungeeCord networks)
- ReportSystem-Velocity.jar (proxy module for Velocity networks)
- Full documentation
- Free updates
Need help? Join our Discord or open a conversation!
Developed by KAREBLOK.TC
installation, documentation: https://kareblok.tc/reportsystem/readme.php?lang=tr
