Sqrilizz's Reports

- Fixed invalid YAML quoting in the Arabic language file, allowing /report-reload to load messages_ar.yml successfully.

[9.5.0] - 2026-07-24

Fixed

- bStats metrics not displaying: added metrics: true to plugin.yml (main cause) - bStats config missing globalSwitch: true; enabled logFailedRequests for error visibility - Fixed bstats badge typo in README

Changed

- Bump version to 9.5.0

[9.4.0] - 2026-07-18

Added

- A separate Bot Edition with moderator buttons for resolving reports or marking them as not a bug / false report - Discord report cards show Minecraft head thumbnails, a status field, the acting moderator, and disabled final controls - Offline-player reports with the target location recorded as offline - Persistent report statuses: open, in progress, resolved, not a bug, not a violation, false report, and closed - Localized status labels and reports-menu statistics in English, Russian, and Arabic - Reporter notifications for every final moderation outcome - Telegram moderation notifications for report status changes - Audit webhook events for report creation, status changes, and report cleanup - Duplicate protection for recent open complaints from the same reporter to the same target - Automatic migration of renamed configuration keys from older releases

Fixed

- Reports menu now previews the newest report for each player - Discord bot buttons acknowledge interactions before the server-side status change - Discord report cards now show the moderator's final decision and disable the action controls - JSON, SQLite, and MySQL stores now persist the final status, moderator, and resolution time consistently

Changed

- The gui.player-heads setting now works for all report GUI cards - The main build now targets Paper 26.2 and Java 25; support for Java 21 and Minecraft 1.21.x has been dropped - Standard Edition and Bot Edition artifacts are both published as version 9.4.0

[9.3.0] - 2026-07-01

Changed

- Verified and declared support for Minecraft 26.2 (new date-based versioning); sources compile cleanly against Paper API 26.2.build.40-alpha - Still compiled against Paper API 1.21.11 with Java 21 bytecode, so the same jar runs on 1.21+ servers (Java 21) and 26.x servers (Java 25) — Paper API 26.x itself requires Java 25 and would break 1.21 compatibility - Updated dependencies: Gson 2.14.0, HikariCP 6.3.0, sqlite-jdbc 3.49.1.0 - runServer test target updated from 1.21.4 to 1.21.11

[9.2.1] - 2026-06-22

Fixed

- Bug reports no longer blocked by the per-player complaint limit (3 of 3) — the limit applies only to player reports, not bug reports - Corrected config key mismatch in limit messages: report-limits.* → anti-abuse.*, so the displayed limit now matches the actual value from config.yml

Added

- New action buttons in GUI: "Notify Player", "Mark Resolved", "Not a Bug / Not a Violation" - Confirmation dialog before Resolved / Not a Bug actions - Player notifications for all report actions - Discord webhooks for notify, resolve, and not-a-bug actions - Persist resolved reports (status, resolvedBy, resolvedAt) instead of deleting them - History display in GUI: resolved reports are shown greyed out with a ✓ badge - Explicit server software support notes: Paper, Purpur, Pufferfish, Spigot, and Folia - Compatibility note for most Paper-compatible forks such as Leaves, Gale, and Canvas

Fixed

- Bug reports now properly populate the reportsById index on load - Fixed openReportActionsGUI showing no-reports instead of report-not-found when a report is missing - Fixed confirmation GUI not being recognized as plugin GUI because of the missing isOurGUI check - Fixed double Discord webhook send on resolve actions - Fixed Gradle/plugin metadata to publish as version 9.2 - Fixed GUI compatibility on legacy and modern versions by resolving renamed materials through VersionUtils - Fixed player head owner handling on old servers by falling back from setOwningPlayer to legacy setOwner

Changed

- Unified action button color scheme using configured GUI colors - Resolved reports are no longer deleted; they are kept in the database with status - Supported server software clarified: Paper, Purpur, Pufferfish, Spigot, and Folia - Paper-compatible forks are documented as likely compatible, not officially tested

Please report any issues to [issues](https://github.com/Sqrilizz/Sqrilizz-Reports/issues)

marked as beta but should work as suposted, but please report any issues.

[9.1] - 2026-05-15

Fixed

- bStats plugin ID corrected from 24619 to 31222 (vibecoded ts)

[9.0] - 2026-05-14

Added

- DebugManager with toggleable debug mode (default: off) - /report-debug command to toggle debug logging - Debug logging in GUI listener (click events, menu detection, button matching) - Debug logging in PunishmentManager (punishment actions, system detection) - Separate bug report format for Telegram and Discord (category instead of target)

Fixed

- GUI button matching now case-insensitive (was breaking buttons like "TP to Reporter" vs "reporter") - Punishment menu title parsing (extract player name between ] and # instead of splitting by -) - Player reports target name extraction (strips trailing ] from title format) - Hardcoded Russian "Назад" button in punishment handler (now uses isButton with all language variants)

Changed

- Bug report notifications now use dedicated format (Reporter, Category, Description, Time, Location) - Admin bug report notification format simplified (shorter field names) - Bug report Discord embed color changed to orange (0xFFA500) to distinguish from regular reports

[7.9] - 2025-04-16

Added

- Bug Report System: New /bugreport command for structured bug reporting - 11 predefined bug categories (duplication, crash, exploit, performance, gameplay, world, inventory, commands, permissions, economy, other) - Category validation with automatic suggestions - Category synonyms support (e.g., dupe = duplication, lag = performance) - Tab completion for categories and example descriptions - Multi-language support for category names (EN/RU/AR) - Admin notifications with category highlighting - Integration with Telegram and Discord webhooks - Same cooldown and anti-abuse protection as regular reports

Changed

- Enhanced Tab Completion: Added comprehensive tab completion for /bugreport command - First argument: all available categories and their synonyms - Second argument: context-aware example descriptions based on selected category

Technical Details

- New BugReportCommand.java with category validation - Updated ReportManager.java with addBugReport() method supporting categories - Enhanced NotificationUtils.java for bug report notifications - Updated ReportsTabCompleter.java with bug report category completion - Added 15+ new language keys across all language files (EN/RU/AR)

[7.8.2] Fix - Reports now properly sync to database when deleted - clearReports() and deleteReport() now update both YAML and DB - Fixes issue where reports reappear after server restart

[7.8.1] Removed all dev logs

[7.8] - 2026.27.03

Added

- Interactive GUI Menu: Added comprehensive GUI system for managing reports - Main reports list with player heads and report counts - Detailed report view with all information - Quick action menu: teleport to players, punish, resolve, or delete reports - Punishment menu with preset options (warn, kick, mute, ban) - Full pagination support for large report lists - Right-click to quickly clear all reports for a player

Changed

- Updated Minecraft API: Updated Paper API from 1.21.10 to 1.21.11 for latest compatibility. ([#5](https://github.com/Sqrilizz/Sqrilizz-Reports/issues/5)) - Enhanced /reports Command: Now opens GUI by default, use /reports list for text-based view Note: `sorry, i was a busy with school and i forgot to update my plugins)`

[7.6] - 2025-11-14

Added

- Optional MySQL Support: The plugin now uses SQLite by default. MySQL support can be enabled by placing the MySQL JDBC driver in the lib folder. - Lightweight Telegram Integration: Replaced the heavy Telegram Bot API with a lightweight HTTP client, significantly reducing the plugin's file size.

Changed

- Optimized Dependencies: Removed and optimized heavy dependencies to reduce the final JAR size from ~30MB to ~17MB. - Updated Documentation: All README files and the Modrinth description have been updated to reflect the latest changes.

Removed

- Unused Commands: Removed the following unused commands to clean up the plugin: - /report-discord - /report-health - /report-stats - Discord Bot Support now there is only discord webhook

Fixed

- Build Compatibility: Resolved build issues related to Java versions and dependency conflicts.

Sqrilizz-Reports v7.5 - Release Notes

New Features

Performance Monitoring System

- PerformanceMonitor - comprehensive metrics and statistics system - Operation tracking: report creation, resolution, deletion, replies - Performance metrics: database operations, cache hits/misses, hit rates - Error counters: database, notifications, cache errors - JVM monitoring: memory usage, thread count, uptime

Health Diagnostics Command

- `/report-health` - system health overview - `/report-health detailed` - comprehensive performance statistics - `/report-health cache` - cache statistics and performance - `/report-health reset confirm` - reset all performance counters

Graceful Shutdown System

- ShutdownManager - proper service termination - Parallel shutdown: REST server, database, cache, Discord/Telegram bots - Final performance report on shutdown - 30-second timeout protection

Performance Optimizations

Critical Performance Improvements

- O(1) report search by ID (was O(n²)) - massive performance boost - ReadWriteLock synchronization - parallel reading instead of blocking - Asynchronous notifications - non-blocking webhook/bot operations - Configurable cache settings - moved to config.yml for tuning

Code Quality Enhancements

- Eliminated code duplication - created NotificationUtils class - Enhanced CommandSender support - improved permission checking - Optimized database operations - better connection handling - Memory efficiency improvements - reduced object allocation

Technical Improvements

Configuration Enhancements

# New performance settings in config.yml
performance:
  cache:
    expire-after-write: 30
    maximum-size: 10000
    record-stats: false

Just an update to 1.21.9

[7.2] - 2025-09-21

Major Features Added

- 🤖 Discord Bot Integration: Full Discord bot with slash commands (/ban, /kick, /mute, /warn, /reports) - 📋 Tab Completion: Complete tab completion for all commands with smart suggestions - 🌍 Multi-Language Documentation: Added Russian and Arabic README versions - 📚 Modular Documentation: Organized documentation into specialized guides

New Features

- Discord Bot with moderation commands and embed notifications - ReportsTabCompleter for enhanced user experience - DiscordBotCommand for easy Discord bot configuration - Language-specific README files (EN/RU/AR) - Specialized documentation in docs/ folder

Technical Improvements

- Added JDA 5.0.0-beta.24 dependency for Discord integration - Enhanced command registration system - Improved plugin initialization order - Better error handling for Discord operations

Documentation

- README.md (English) - Main documentation - README-RU.md (Russian) - Russian version - README-AR.md (Arabic) - Arabic version with RTL support - docs/DISCORD_BOT.md - Complete Discord Bot guide - docs/API.md - Developer API documentation - docs/INSTALLATION.md - Installation guide - docs/CONFIGURATION.md - Configuration reference - docs/TELEGRAM.md - Telegram integration - docs/ANTI_ABUSE.md - Anti-abuse system guide - docs/DESIGN.md - Design system documentation

Updated Files

- Main.java - Added Discord bot initialization - plugin.yml - Added /report-discord command - build.gradle - Added JDA dependency - All README files updated with new version badges

New Features:

Player Coordinates

- Automatic coordinate saving for both reporter and target in every report - Detailed location information including world, X, Y, Z coordinates - Enhanced moderation - quickly locate incident scenes

Advanced Timestamps

- Precise creation time for each report (dd.MM.yyyy HH:mm:ss) - Relative time display (e.g., "5 minutes ago", "2 hours ago") - Better tracking of report history and patterns

Plugin Statistics Command

- `/report-stats` - comprehensive plugin overview - Report counts and unique player statistics - Name cleaning settings and server information - Integration status (Telegram/Discord)

Configuration Reload

- `/report-reload` - reload config without server restart - Dynamic updates for name cleaning and integration settings - Hot-reload all managers and configurations

Discord Embeds

- Beautiful embed messages instead of plain text - Structured information with coordinates, time, and reason - Color-coded alerts and organized data fields - Professional appearance for Discord notifications

Enhanced Telegram Notifications

- Rich message format with coordinates and timestamps - Bot interaction - responds to /start command - Better readability and information density

New Commands:

- `/report-stats` - View comprehensive plugin statistics - `/report-reload` - Reload plugin configuration

Use Cases:

- Server Moderation - Quick incident location identification - Player Tracking - Monitor report patterns and locations - Admin Tools - Enhanced reporting and management capabilities - Integration - Professional Discord and Telegram notifications ---- Credits to [notsethsc](https://github.com/notsethsc)

[7.0] - 2025-08-18

Major Features

- Multi-Version Support: Full support for Minecraft versions 1.8.9 to 1.21.8 - Folia Support: Complete compatibility with Folia servers - UUID Support: Modern player identification with fallbacks for older versions - Version Detection: Automatic server version detection and compatibility adjustment - Multi-Release JAR: Enhanced JAR structure for better version compatibility - Enhanced Performance: Optimized for all supported versions

Technical Improvements

- VersionUtils Class: Comprehensive utility class for handling version-specific operations - Enhanced Main Class: Advanced version detection and Folia support - Updated CooldownManager: Modern UUID-based system with legacy fallbacks - Improved Scheduler: Version-compatible scheduler with Folia support - Better Error Handling: Enhanced error handling for different versions - Optimized Memory Usage: Reduced memory footprint across all versions

Code Changes

#### New Files - VersionUtils.java - Version compatibility utility class - VERSION_COMPATIBILITY.md - Detailed version compatibility guide - BUILD_INSTRUCTIONS.md - Build instructions for different versions #### Updated Files - Main.java - Added version detection and Folia support - build.gradle - Updated for multi-version support - plugin.yml - Updated API version and added platform support - config.yml - Enhanced configuration with version compatibility settings - CooldownManager.java - Updated to use UUIDs with legacy support - ReportCommand.java - Updated to use VersionUtils - AdminReportsCommand.java - Updated to use VersionUtils - LanguageCommand.java - Updated to use VersionUtils - TelegramCommand.java - Updated to use VersionUtils - WebhookCommand.java - Updated to use VersionUtils - ReportManager.java - Updated to use version-compatible scheduler - TelegramManager.java - Updated configuration paths and scheduler - DiscordWebhookManager.java - Updated configuration paths and scheduler

Configuration Changes

- Updated Telegram configuration paths (bot-token → token, chat-id → chat_id) - Updated Discord configuration paths (webhook-url → discord.webhook_url) - Added version compatibility settings - Enhanced permission system configuration - Added new message keys for webhook commands - Improved configuration structure and organization

Backward Compatibility

- Legacy Support: Maintains compatibility with older versions using fallbacks - UUID Fallbacks: Uses name-based identification for very old versions - API Fallbacks: Provides reflection-based fallbacks for deprecated APIs - Permission Fallbacks: Graceful degradation for older permission systems - Automatic Migration: Seamless upgrade from previous versions

Performance Improvements

- Optimized Scheduler: Better performance with Folia's regional scheduler - Reduced Memory Usage: More efficient UUID handling - Faster Version Detection: Optimized version checking algorithms - Better Async Operations: Improved asynchronous task handling - Enhanced Caching: Better resource management

Bug Fixes

- Fixed permission checking for older versions - Resolved scheduler compatibility issues - Fixed configuration loading problems - Corrected message handling for different languages - Improved error reporting and debugging

Command Updates

- All commands now use VersionUtils for compatibility - Enhanced error messages and user feedback - Better permission handling - Improved command validation - Added command suggestions and help

Integration Updates

- Telegram: Updated configuration and error handling - Discord: Enhanced webhook management - Language System: Improved multi-language support - Permission System: Better permission management - Plugin Hooks: Better integration with other plugins

Version Support Matrix

| Version Range | Status | Key Features | |---------------|--------|--------------| | 1.8.9 - 1.11.x | Supported | Legacy fallbacks, basic features | | 1.12.x - 1.15.x | Supported | Full compatibility, enhanced features | | 1.16.x | Supported | Modern API, optimal performance | | 1.17.x - 1.18.x | Supported | Latest features, Java 16+ | | 1.19.x | Supported | Enhanced security, modern Java | | 1.20.x | Supported | Latest updates, best performance | | 1.21.x | Supported | Cutting-edge features, Folia support |

Platform Support

- Paper: Full support with optimal performance - Spigot: Full support with good performance - Folia: Full support with regional scheduling - Bukkit: Basic support for legacy servers

Changelog

\[6.0.0] – 2025-07-22

- updated for 1.21.8 - if you found some issues, please report them on github

Changelog

\[5.0.0] – 2025-07-08

- Downgraded for 1.16.5 (Tmrw is my birthday )

Changelog

\[4.0.0] – 2025-07-01

- updated for 1.21.7 - if you found some issues, please report them on github

Changelog

\[3.0.0] – 2025-06-15

- updated for 1.21.6

Changelog

\[2.1.0] – 2025-06-15

#### Initial Release - updated for 1.21.5

Changelog

\[1.0.0] – 2025-06-15

#### Initial Release * Basic player reporting system: * /report <player> <reason> – Submit a report * /reports – View all reports * /reports check <player> – Check reports for a player * /reports clear <player> – Clear reports for a player * /reports clearall – Clear all reports * Admin tools: * /report-language <ru|en> – Change plugin language * /report-telegram token <token> – Set Telegram bot token * /report-telegram chat <id> – Set Telegram chat ID * /report-webhook set/remove – Configure Discord webhook * Telegram and Discord notification support * YAML-based configuration (config.yml) * Permissions system (reports.report, reports.admin, etc.) * Multilingual support (Russian and English) * Cooldown and auto-ban threshold options