ReportCheckViewer

ReportCheckView

A powerful moderation system for Minecraft Paper 1.20+ servers, allowing players to report rule-breakers and staff to handle cases efficiently.

Features

🎯 Core Features

- Multi-Language Support - Players can report rule-breakers with a simple command - Multi-Language Support - User-friendly interfaces for both players and staff - Multi-Language Support - Organize reports by violation type (Cheating, Griefing, Chat, etc.) - Multi-Language Support - Prevent report spam with configurable cooldowns - Multi-Language Support - Fully customizable messages in any language

👮 Staff Tools

- Quick Actions - View, filter, and manage all reports - Quick Actions - Get notified instantly when new reports are submitted - Quick Actions - Claim reports or auto-assign to available staff - Quick Actions - Full history of all actions taken on reports - Quick Actions - Accept, reject, or close reports with one click

🤖 Automation

- Statistics Tracking - Automatically take action based on report thresholds - Statistics Tracking - Multiple notification types (chat, title, sound, action bar) - Statistics Tracking - Automatically close old inactive reports - Statistics Tracking - Track report trends and staff performance

💾 Storage

- Auto-save - Choose between SQLite (default) or MySQL - Auto-save - 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> [reason]` | Report a player | `reportcheckview.report` |

Staff Commands

| Command | Description | Permission | |---------|-------------|------------| | `/reportcheck [id]` | 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. Close - Click on a report to open details - Close - Assign the report to yourself - Close - Mark as valid and take action - Close - Mark as invalid - Close - Teleport to the reported player - Close - Close without action

3. Viewing Player History ``` /cases PlayerName ``` - Shows all reports for a specific player - Useful for identifying repeat offenders

Database Setup

SQLite (Default)

No setup required! The plugin will automatically create a database file.

MySQL (Optional)

1. Edit `config.yml`: ```yaml storage: type: MYSQL mysql: host: localhost port: 3306 database: reportcheckview username: your_username password: your_password ``` 2. Reload the plugin: `/reportadmin reload`

Customization

Adding Custom Categories

Edit `config.yml`: ```yaml reports: categories: - Cheating/Hacking - Griefing - Your Custom Category ```

Customizing Messages

Edit `messages_en.yml` to change any message in the plugin. You can also create new language files (e.g., `messages_nl.yml` for Dutch).

License

This project is licensed under the MIT License - see the LICENSE file for details.

Credits

- Author: Samuele_NL

Screenshots

Player Report GUI

Players can easily report rule-breakers with an intuitive category selection interface.

Staff Management Interface

Staff members have access to a comprehensive report management system with filtering and quick actions.

Real-time Notifications

Staff receive instant notifications when new reports are submitted, with clickable messages to view details.

---

Made with ❤️ for the Minecraft community