ReportCheckViewer

# ReportCheckView A powerful moderation system for Minecraft Paper 1.20+ servers, allowing players to report rule-breakers and staff to handle cases efficiently. !(https://img.shields.io/badge/version-1.0.0-blue) !(https://img.shields.io/badge/minecraft-1.20+-green) !(https://img.shields.io/badge/paper-required-orange) ## Features ### 🎯 Core Features - **Easy Report Submission** - Players can report rule-breakers with a simple command - **Interactive GUIs** - User-friendly interfaces for both players and staff - **Category System** - Organize reports by violation type (Cheating, Griefing, Chat, etc.) - **Smart Cooldowns** - Prevent report spam with configurable cooldowns - **Multi-Language Support** - Fully customizable messages in any language ### 👮 Staff Tools - **Comprehensive Report Management** - View, filter, and manage all reports - **Real-time Notifications** - Get notified instantly when new reports are submitted - **Report Assignment** - Claim reports or auto-assign to available staff - **Action Tracking** - Full history of all actions taken on reports - **Quick Actions** - Accept, reject, or close reports with one click ### 🤖 Automation - **Auto-moderation** - Automatically take action based on report thresholds - **Smart Notifications** - Multiple notification types (chat, title, sound, action bar) - **Auto-close** - Automatically close old inactive reports - **Statistics Tracking** - Track report trends and staff performance ### 💾 Storage - **Dual Database Support** - Choose between SQLite (default) or MySQL - **Efficient Caching** - Fast access to active reports - **Auto-save** - Periodic automatic saving ## Installation 1. Download the latest `ReportCheckView.jar` from the releases page 2. Place the JAR file in your server's `plugins` folder 3. Restart your server 4. Configure the plugin in `plugins/ReportCheckView/config.yml` 5. Customize messages in `plugins/ReportCheckView/messages_en.yml` ## Commands ### Player Commands | Command | Description | Permission | |---------|-------------|------------| | `/report <player> ` | Report a player | `reportcheckview.report` | ### Staff Commands | Command | Description | Permission | |---------|-------------|------------| | `/reportcheck ` | Open report management GUI | `reportcheckview.staff` | | `/cases <player>` | View all reports for a player | `reportcheckview.staff` | | `/reportstats` | View report statistics | `reportcheckview.staff` | ### Admin Commands | Command | Description | Permission | |---------|-------------|------------| | `/reportadmin reload` | Reload configuration | `reportcheckview.admin` | ## Permissions | Permission | Description | Default | |------------|-------------|---------| | `reportcheckview.report` | Allow submitting reports | `true` | | `reportcheckview.staff` | Access to staff tools | `op` | | `reportcheckview.notify` | Receive report notifications | `op` | | `reportcheckview.admin` | Administrative access | `op` | | `reportcheckview.bypass` | Bypass cooldowns and limits | `op` | ## Configuration The plugin is highly configurable. Here are some key settings: ### Report Settings ```yaml reports: cooldown: 60 # Cooldown between reports (seconds) max-active-reports: 3 # Maximum active reports per player require-reason: true # Require a reason when reporting min-reason-length: 10 # Minimum reason length auto-close-days: 7 # Auto-close after X days ``` ### Notification Settings ```yaml notifications: sound-enabled: true # Play sound for staff chat-enabled: true # Send chat messages title-enabled: true # Show title notifications notify-reporter: true # Notify reporter when action is taken ``` ### Automation Settings ```yaml automation: enabled: true thresholds: 3: - "notify:&cPlayer %player% has 3 reports!" 5: - "command:tempban %player% 1h Multiple reports" ``` ## Usage Guide ### For Players 1. **Reporting a Player** ``` /report PlayerName ``` - Select a category from the GUI - Choose or provide a reason - Submit the report 2. **What Happens Next** - Your report is sent to online staff members - Staff will investigate and take appropriate action - You'll be notified if action is taken (if enabled) ### For Staff 1. **Viewing Reports** ``` /reportcheck ``` - Opens the report management GUI - Filter by status (Pending, In Progress, Resolved) - Click any report to view details 2. **Handling a Report** - Click on a report to open details - **Claim** - Assign the report to yourself - **Accept** - Mark as valid and take action - **Reject** - Mark as invalid - **Teleport** - Teleport to the reported player - **Close** - Close without action 3. **Viewing Player History** ``` /cases PlayerName ``` - Shows all reports for a specific player