🚀 Sqrilizz-Reports v7.8 - Interactive GUI Edition

A professional, high-performance reports management system for Minecraft servers with intuitive GUI interface and powerful moderation tools.

🎮 NEW in v7.8: Interactive GUI System

Manage reports visually with an intuitive interface:

✨ Visual Report Browser - Browse reports with player heads
⚡ One-Click Actions - Teleport, punish, resolve instantly
🎯 Punishment Presets - Warn, kick, mute, ban with one click
🔄 Smart Navigation - Pagination, back buttons, smooth transitions
🌍 Multi-Language GUI - Full support for EN/RU/AR in all menus
📱 Mobile-Friendly - Works great on any screen size

📋 What This Plugin Does

Sqrilizz-Reports provides server administrators with a complete player reporting system:

Interactive GUI - Visual report management with player heads and quick actions
Player Reporting - Players report violations with /report <player> <reason>
Admin Tools - Review, punish, and resolve reports through GUI or commands
Multi-Platform Notifications - Discord webhooks, Telegram integration
Anti-Abuse Protection - Rate limiting and false report detection
REST API - External integration for web panels and tools
Multi-Language - English, Russian, and Arabic translations

✨ Core Features

🎮 Interactive GUI System

Main Menu - View all reported players with heads
Player Reports - See all reports for specific player
Actions Menu - Teleport to reporter/target, punish, resolve
Punishment Menu - Warn, kick, mute (1h/1d), ban (1d/7d/perm)
Confirmation - Choose to close report after punishment
Smooth Transitions - Fluid navigation between menus

🎨 Beautiful Design

Hex color support for Minecraft 1.16+ with legacy fallbacks
Modern emoji integration for enhanced UX
Customizable color palette with 7 predefined themes
Clean interface with intuitive controls

�️ Advanced Anti-Abuse

Rate limiting: Per-player and hourly limits
False report detection with automatic credibility adjustment
Smart cooldowns based on player behavior
Automatic cleanup of old data

🌍 Multi-Language Support

3 Languages: English, Russian, Arabic
RTL support for Arabic text
Separate language files for easy customization
Hot reload with /report-reload

� Integrations

Telegram - Instant notifications to your bot
Discord - Webhook support for channels
REST API - Token auth, IP whitelist, HMAC
Developer API - Events and methods for plugins

🔧 Commands Overview

� Player Commands

/report <player> <reason>       — Report a player for violations

�️ Admin Commands

/reports                        — Open interactive GUI menu
/reports list                   — View reports in chat
/reports check <player>         — Check reports for specific player
/reports clear <player>         — Clear reports for a player
/reports clearall               — Clear all reports
/report-reload                  — Reload plugin configuration

📱 Integration Commands

/report-language <en|ru|ar>     — Change server language
/report-telegram token <token>  — Set Telegram bot token
/report-telegram chat <id>      — Set Telegram chat ID
/report-webhook set <url>       — Set Discord webhook URL
/report-webhook remove          — Remove webhook

🎮 GUI Usage Guide

Main Menu (`/reports`)

See all players with active reports (player heads)
Left-click player head → View their reports
Right-click player head → Clear all reports for player
Use pagination arrows for more players

Player Reports Menu

View all reports for selected player
Click report item → Open actions menu
Teleport button → TP to reported player
Clear all button → Remove all reports

Report Actions Menu

TP to Reporter → Teleport to who reported
TP to Target → Teleport to reported player
Punish → Open punishment menu
Resolve → Mark as resolved (deletes report)
Delete → Remove without action

Punishment Menu

Select punishment type:
- Warning, Kick, Mute (1h/1d), Ban (1d/7d/perm)
After punishment, choose:
- Close Report → Resolve and delete
- Keep Report → Return to reports
- Close Menu → Exit without action

🖥️ Compatibility

Minecraft Versions: 1.8.9 - 1.21.11 (All versions supported)
Server Software: Paper (recommended), Spigot, Folia
Java: 21+ required

Note: The plugin automatically detects your server version and adapts features accordingly.

⚙️ Configuration

📄 Basic config.yml

# Language (en, ru, ar)
language: en

# Anonymous reports
anonymous-reports: false

# Cooldown between reports (seconds)
cooldown: 60

# Anti-abuse limits
report-limits:
  per-player: 3    # Max reports per player
  per-hour: 10     # Max reports per hour

# Design settings
design:
  use-hex-colors: true
  colors:
    primary: "#FF6B6B"
    secondary: "#4ECDC4"
    success: "#45B7D1"

� Database

database:
  type: sqlite   # Default, works out-of-the-box
  # MySQL optional - requires driver in lib/ folder

🧪 Permissions

Permission	Description	Default
`reports.report`	Use `/report` command	✅ Everyone
`reports.admin`	Access admin commands & GUI	👑 OPs only
`reports.language`	Change server language	👑 OPs only
`reports.telegram`	Configure Telegram	👑 OPs only
`reports.reload`	Reload configuration	👑 OPs only

🛠️ Developer API

📦 Quick API Usage

// Create a report programmatically
ReportAPI.createReport(player, target, "Automated detection");

// Listen for report events
ReportAPI.onReportCreate(event -> {
    // Handle new report
});

// Get reports for a player
List<Report> reports = ReportAPI.getReports(player);

🔔 Integrations

📱 Telegram Bot

Instant report notifications
Moderation commands via Telegram
Admin-only access control
Rich message formatting

🔗 Discord Webhooks

JSON webhook support
Custom integrations
Automated report processing

📚 Documentation

🌍 Multi-Language READMEs

🇺🇸 English: README.md
🇷🇺 Russian: README-RU.md
🇸🇦 Arabic: README-AR.md

📖 Specialized Guides

� GUI Guide: Complete GUI Usage
� Telegram: Telegram Setup
🛠️ API: Developer API
🌐 REST API: REST API Reference
💾 Database: Database Guide
⚙️ Configuration: Config Reference
�️ Anti-Abuse: Protection System

📞 Support & Community

🆘 Get Help

� Telegram: Follow for updates
📚 Documentation: GitHub Wiki
🐛 Bug Reports: GitHub Issues
💡 Feature Requests: GitHub Discussions

🎯 Key Benefits

✅ Complete Solution - Everything you need for player reporting
✅ Easy Setup - Works out of the box with sensible defaults
✅ Intuitive GUI - Visual interface for efficient moderation
✅ Scalable - Handles small servers to large networks
✅ Reliable - Tested across multiple Minecraft versions
✅ High Performance - Optimized for minimal server impact
✅ Extensible - REST API and webhook support
✅ Well Maintained - Regular updates and active support

A professional reporting system that grows with your server.

Sqrilizz | Report