ReportDesk

ReportDesk is not just a /report plugin. It is a complete, enterprise-grade server governance and ticketing system designed for serious Paper servers.

Built with a zero-lag Write-Ahead Log (WAL) architecture, advanced SLA tracking, and full-spectrum evidence collection, ReportDesk replaces clunky chat reports with a professional, GUI-driven workflow.

⚡ Why ReportDesk? (The Highlights)

• 🚀 Zero-Lag Backend: Built with WAL (Write-Ahead Logging) and fully asynchronous I/O. Zero file-IO on the main thread. Handles thousands of reports without a single tick drop.
• 🕵️ Full-Spectrum Evidence: Auto-captures player inventory, armor, health, ping, location, recent chat, and even movement replays (replay logs) at the exact moment of the report.
• ⏱️ SLA & Ticketing System: Never miss a report. Features severity levels, repeat-offender auto-escalation, overdue tracking, and in-game reminders.
• 🛡️ Crash Safe: 184 unit tests and WAL compaction ensure data is never lost, even during a sudden server crash.

🔥 Feature Breakdown

🛡️ Player Experience

• Beautiful GUI: Interactive, categorized reporting GUI with chat context selection.
• Ticket Tracking: Players can view statuses, read staff replies, and communicate directly within the report thread.
• Anti-Abuse: Highly configurable cooldowns, daily limits, and duplicate detection.

⚙️ Admin Workbench (/reports)

• Ticketing Flow: Claim, Release, Close (with verdicts), Reopen, and Purge.
• Watchlist: Add toxic players to a watchlist for automatic alerts on future reports.
• In-Game Config Editor: Modify any config value on the fly without restarting. Fully audited.
• Audit Logs: Every admin action (claim, close, note) is logged, paginated, and viewable via /reports audit.

🔍 Evidence Layer (Default: OFF)

When enabled, the plugin short-circuits and captures:

• Snapshot: Inventory, Armor, Gamemode, Y-Level, Ping, Health.
• Chat Context: Recent public chat logs and custom chat-reports.
• Replay Logs: Replays the player's movement and block-break history leading up to the report.
• Auto-Detection: Generates system reports for sudden spikes in block breaking (X-Ray/Nuker detection).
• Webhook Integration: Push new reports and evidence directly to Discord.

🛠️ Technical Excellence

• API Version: 1.20 (Java 17 bytecode compatible, runs on 1.20 - 1.21+).
• Storage: WAL + periodic compaction (reports.log -> reports.json).
• Permissions: Granular 11-node permission system.
• i18n: 100% translatable (Built-in ZH_CN / EN_US).