PunishmentX

· ️ Fully Decoupled GUI Design (gui.yml): Extracted all visual layouts, category materials, slots, and size parameters out of config.yml into a dedicated gui.yml, making the GUI layouts and borders ultra-customizable. · 100% Translatable & Localization Clean-up: Evacuated all remaining hardcoded text strings in commands, staff stats, leaderboard heads, case exporters, freeze restrictions, and anti-raid logs into messages.yml, allowing server admins to translate the entire plugin. · Interactive Proof Books (GUI): Clicking a sanction with attached proof inside the history GUI now opens a virtual interactive Minecraft Book containing clickable URLs, letting staff review evidence in-game without cluttering chat. · AI-Moderation Auto-Mute Triggers: Enabled automated temporary muting (e.g. 10m) if a player's toxicity patterns repeatedly trigger warnings consecutively. · Extended Network Synchronisation (Redis): Real-time Pub/Sub sync now covers screenshare freezes (/freeze), staff chat (/staffchat), staff lockdowns, and staff action limits across multi-server environments. · Native BungeeCord & Velocity Support (Universal JAR): Introduced complete, native support for BungeeCord and Velocity proxies packaged within a single, optimized universal JAR. · ️ Proxy-Level Connection Filtering: Enforces active bans, subnet locks, Cloud Blacklist, and Anti-VPN checks directly at the proxy gateway stage, saving backend Spigot server resources and avoiding connection-transfer hops. · Anti-Escape Server-Switch Block: Syncs screenshare freezes (/freeze) with the proxy. If a player is frozen, the proxy blocks them from changing backend servers, keeping them locked on their current server during inspection. · Proxy StaffChat & Reload Commands: Registered proxy-side /staffchat (alias /sc) with real-time Redis broadcasting to Spigot backends, and added /punishmentxproxy reload (/pxp reload) to hot-reload proxy configurations. · Chat Serialization Optimization: Optimized Component-to-String plain text translation in chat handling to parse messages exactly once, avoiding redundant operations and significantly reducing Netty chat thread latency under high player loads. · Dynamic Cross-Server Ban Layouts: Redis synchronization triggers are now fully translatable. Cross-server bans display the identical detailed, customizable ban layout (appeal codes, links, durations) configured by the network administrator. Technical Optimizations & Performance Safety · Parallel Pre-Login Execution: Consolidated database and VPN pre-login checks into a concurrent execution pool with a 3s safety timeout, protecting login threads from sequential database latency. · ️ IP Rate Limiter (Anti-Bot): Kicks player floods when more than N unique accounts connect from the identical IP address within rolling 5-minute windows. · ️ Persistent GeoIP Caching (DB): Introduced a geoip_cache table to store country and ISP lookups locally, preventing redundant external API calls and rate-limit blocks. · Multi-Server State Persistence: Frozen and locked player states are now backed by persistent database tables (frozen_players and locked_players) and loaded during pre-login. · ️ DB Layer & Connection Pool Safety: Audited all SQL statements in PunishmentManager, PlayerManager, and StaffStatsManager. Every connection is cleanly enclosed in try-with-resources to prevent HikariCP leaks. All queries execute asynchronously via CompletableFuture to protect the Minecraft main tick thread. · In-Memory Caffeine Caching: Caches UUID-to-Profile correlations to avoid recurring database lookups on GUI loads, and keeps active punishments cached for instant chat/action verification. · Web Request & Timeout Safety: Enforces strict timeouts on GeoIP API requests (3s) and Discord Webhook requests (5s) with explicit socket resource releasing to prevent connection hanging. · Safe Redis Pub/Sub Lifecycle: Prevented background thread leaks and console error spam on server reloads/shutdown by interrupting the Redis subscriber thread and validating pool status. · Database Query & Indexing Optimization: Added missing database indexes on notes(target_uuid) and reports(status, reported_uuid) for both MySQL and SQLite, preventing full table scans on large datasets. · ️ Code Quality & Null Safety Improvements: Resolved compiler warnings related to null type safety in ConnectionListener and AntiVPNManager, ensuring cleaner builds and stricter null check conformance.