ReportMaster+

A professional Minecraft plugin enabling player reporting via commands, featuring a robust web-based dashboard for staff report management with role-based permissions.

Features

In-Game Features
- Player Reporting System - Easy-to-use commands for reporting problematic players
- Staff Management Tools - View, close, and delete reports with proper permissions
- Cooldown System - Prevent spam reporting with configurable cooldowns
- Real-time Notifications - Staff receive instant notifications when reports are submitted
- IP Logging - Optional IP address logging for enhanced security (configurable)
- Comprehensive Help System - Built-in help command showing all available commands

Web Dashboard Features
- Role-based Access Control - Admin and Moderator roles with distinct permissions
- Responsive Design - Works seamlessly on desktop and mobile devices
- Real-time Statistics - Dashboard with report statistics and charts
- Advanced Filtering - Filter reports by statu
- User Management Interface - Admin-only user creation and management system
- Activity Monitoring - Comprehensive audit logging for all administrative actions
- IP Privacy Controls - Moderators see masked IP addresses for enhanced privacy
- Secure Authentication - BCrypt password hashing and session management

Installation

1. Download the latest ReportMaster+ JAR file
2. Place it in your server's `plugins` folder
3. Restart your server to generate configuration files
4. Configure the plugin by editing `config.yml`
5. Create web panel users using `/reportweb create` command
6. Access the web panel at ` http://your-server-ip:8080`

Dependencies
- Java 17 or higher
- Bukkit/Spigot/Paper 1.19+
- MySQL (optional, SQLite is used by default)

Commands

Player Commands
Command Description Permission Usage
-----------------------------------------
`/report <player> <reason>` Submit a report against a player `report.use` `/report Griefer123 Destroying builds`
`/reporthelp` Show all available commands None `/reporthelp`

Staff Commands
Command Description Permission Usage
-----------------------------------------
`/reportlist [page]` View list of active reports `report.view` `/reportlist 2`
`/reportinfo <id>` View specific report details `report.view` `/reportinfo 123456`
`/reportclose <id>` Close a report `report.manage` `/reportclose 123456`
`/reportdelete <id>` Permanently delete a report `report.manage` `/reportdelete 123456`

Administrator Commands
Command Description Permission Usage
-----------------------------------------
`/reportweb create <username> <password> <role>` Create web panel user `reportweb.admin` `/reportweb create staff123 securepass admin`
`/reportweb reset <username> <password>` Reset web user password `reportweb.admin` `/reportweb reset staff123 newpassword`
`/reportweb list` List all web panel users `reportweb.admin` `/reportweb list`
`/reportweb delete <username>` Delete a web panel user `reportweb.admin` `/reportweb delete staff123`
`/reportmaster reload` Reload plugin configuration `reportmaster.reload` `/reportmaster reload`

Permissions

Permission Node Description Default
--------------------------------------
`report.use` Allow submitting reports
`report.view` Allow viewing report list and details
`report.manage` Allow closing/deleting reports
`report.ip.view` Allow viewing logged IP addresses
`reportweb.admin` Allow managing web panel users
`reportmaster.reload` Allow reloading plugin configuration

Web Panel

Accessing the Web Panel
1. URL: ` http://your-server-ip:8080` (configurable port)
2. Login: Use credentials created with `/reportweb create` command
3. Authentication: Username/password or UUID-based (configurable)

Dashboard Features
- Statistics Overview: Total, open, and closed reports with visual charts
- Recent Reports: Quick view of latest submissions with status indicators
- Role-based Interface: Customized dashboard based on user permissions
- Quick Actions: Fast access to common moderation tasks
- Search & Filter: Advanced filtering options for efficient report management

Security & Privacy
- Session Management: Secure login sessions with automatic timeout
- IP Masking: Privacy-focused IP address handling for different roles
- Audit Trails: Complete logging of all administrative actions
- Input Validation: Protection against malicious input and injection attacks

User Roles

Admin Role (admin)
Complete system administration with full oversight capabilities:

Web UI Access:
- Dashboard: Comprehensive statistics with detailed analytics and charts
- Report Management: Full access to view, close, delete, all reports
- User Administration: Dedicated user management interface for creating, modifying, and removing staff accounts
- Activity Monitoring: Complete audit log viewer with search, filter, and export capabilities
- IP Management: Full IP address visibility and management tools

Administrative Features:
- Create and delete moderator and admin accounts
- View complete activity logs of all staff members
- Access to sensitive information including full IP addresses
- System configuration and maintenance controls

Moderator Role (moderator)
Focused report management with privacy-conscious access:

Web UI Access:
- Dashboard: Report-focused statistics and active case overview
- Report Handling: View and close reports with commenting capabilities
- Search Tools: Advanced filtering and search for efficient case management
- Privacy Controls: Access to masked IP information for security purposes

Privacy & Security:
- IP addresses are automatically masked (e.g., 192.168.1.*)
- No access to user management or system administration
- Limited to report-related activities only
- Cannot view audit logs or administrative actions
- Focused interface to minimize distractions and security risks


Database

- Default Setup (SQLite)
- No configuration required - works out of the box
- File location: `plugins/ReportMasterPlus/reports.db`
- Automatic migration available when switching to MySQL
- Built-in backup system for data protection

MySQL Setup
1. Update config: Set database type to "mysql" and provide credentials
2. Automatic migration: Plugin will migrate existing SQLite data on startup
3. Connection pooling: Optimized for high-performance servers

Database Schema
The plugin creates and manages the following tables:
- `reports` - Store all report data with comprehensive indexing
- `web_users` - Web panel user accounts with encrypted passwords
- `report_cooldowns` - Track reporting cooldowns to prevent spam

Security Features

- Authentication & Authorization
- BCrypt Password Hashing - Industry-standard password security
- Role-based Access Control - Granular permissions system
- Multi-factor Support - UUID and password-based authentication modes

Privacy Protection
- IP Address Masking - Automatic IP privacy for moderator roles
- Data Minimization - Only necessary information is stored and displayed
- Audit Logging - Complete tracking of all administrative actions
- Session Security - Secure session tokens and automatic expiration


Administrative Controls
- Activity Monitoring - Real-time tracking of all staff actions
- Permission Auditing - Regular validation of user permissions and access
- User Management - Centralized control over staff account lifecycle

Migration & Upgrades

- SQLite to MySQL Migration
1. Configure MySQL in config.yml with proper credentials
2. Restart server - automatic migration will occur with progress logging
3. Verify data integrity in the web panel dashboard
4. Backup original SQLite file for safety and rollback capability
​