SinceDungeon

🚀 SinceDungeon v1.5.7: The Rogue-like, Optimization & Security Update

This massive release focuses on heavily optimizing the core systems, introducing rogue-like mechanics, patching critical gameplay vulnerabilities, and completely de-hardcoding internal messages to support full localization.

✨ Features & Gameplay

• Interactive Leaderboard GUI: Introduced a fully Async Database querying system to render leaderboards without lag spikes. Added the /dungeon top <map> command to switch between Fastest Clears, Most Kills, and Most Clears.
• Added Spectator Mode: Party members who run out of lives can now stay and spectate their teammates instead of being kicked. The dungeon only fails if the entire party is wiped out. (Configurable via out-of-lives-action: "SPECTATE" in config.yml).
• Added Admin Spectate: Admins can now silently teleport into active dungeons to supervise players and catch hackers using /dungeon spectate <player>.
• [NEW] Action - Control The Zone: Added a "King of the Hill" objective. Players must hold a specific zone for a set amount of time. Supports shrinking/expanding radius, requiring 75% party presence, and spawning interference mobs.
• [NEW] Action - Unlock Door & Find Key: Added a new action where players must locate a custom Key to unlock a specified door (trigger block). Includes a dynamic Tracking Compass to guide players to the key.
• [NEW] Action Time Limits & Penalties: You can now set time_limit and time_penalty for any action. Failing to complete the action in time deducts lives and restarts the stage.
• [NEW] Rogue-like Randomization: Added randomize-stages setting to shuffle middle stages, making every dungeon run feel unique while preserving the first and last stages (Boss rooms).
• [NEW] Percent Chance Stages: Stages can now have a spawn chance (1-100%), allowing for rare secret treasure rooms or random traps.
• [NEW] Dynamic Party Scaling: Added a scale_with_party toggle to all mob-spawning actions to multiply enemy counts based on the active party size.
• [NEW] Mixed Mob Waves: The Random Wave action now allows spawning a weighted mixture of Vanilla and MythicMobs within the exact same wave.

🛡️ Security & Exploit Fixes

• Critical Inventory Exploit Patched: Completely rewrote the PlayerState snapshot logic in DungeonGame.java. The system now performs a deep-clone of the player's entire inventory (main inventory, armor, offhand) and EXP levels before entry. This prevents players from bypassing the keep-inventory-on-death: false rule or smuggling OP items into dungeons to farm.
• Cross-Server Memory Leak Fixed: Resolved a severe vulnerability where Party Leaders disconnecting during the BungeeCord/Redis transfer window would leave a "ghost" dungeon node running in the RAM forever. The PlayerQuitEvent now triggers cancelPendingRequest to instantly abort orphaned network tasks.
• Admin Spectate Bug Fix: Resolved a critical logic flaw where Admins using /dungeon spectate were incorrectly flagged as unauthorized intruders and kicked by the DungeonListener.

⚡ Performance & Optimizations

• Action Bar TPS Drop Fixed: Stopped the plugin from repeatedly querying the YAML configuration 5 times per second during the runTick() loop. Objective HUD strings are now cached natively inside the DungeonGame constructor, eliminating unnecessary I/O overhead and significantly improving TPS.
• Smart Garbage Collection: The RewardSessionManager now fetches its timeout limit dynamically from the configuration. Replaced rigid timers with thread-safe ConcurrentHashMap loops to prevent CME exceptions during rapid inventory clicks.
• HikariCP Integration: Upgraded the database management system to use HikariCP connection pooling for both MySQL and SQLite. This drastically improves database performance, prevents connection leaks, and reduces query latency.

🛠️ Under The Hood & Refactoring

• ItemBuilder Pattern: Completely refactored ItemCreator into a flexible, chainable ItemBuilder. Now natively uses PersistentDataContainer (NBT Tags) to securely track Custom Keys and Compasses (preventing rename exploits) and fully supports 1.21+ item components.
• Massive Package Restructure: Completely reorganized the source code into a clean, modern Layered Architecture (commands/, managers/, listeners/, hooks/, models/, guis/, utils/).
• Command System Overhaul: Migrated all commands out of the main class into separate, dedicated command classes for easier maintenance.
• Editor GUI Optimization (MVC): Separated the Editor's visual rendering (EditorGUI) and click event listening (EditorMenuListener) into distinct classes.
• Cleaned Up Registries: Extracted all default Action and Processor registrations into a standalone DefaultRegistry class to reduce bloat in the DungeonManager.

🌐 Localization & De-Hardcoding

• 100% Locale Support: Relocated all remaining hardcoded console logs (Database initializations, API registrations, World cleanups) to messages.yml.
• PAPI Integration Fixed: Removed hardcoded English outputs ("Full" and "Never") in PlaceholderAPI (%sincedungeon_lives_time_to_regen%). These can now be seamlessly translated in the language files.

⚠️ How to Update: Please completely regenerate or manually update your config.yml and messages_<lang>.yml files to access the newly added Spectator mode settings, Leaderboard configs, and new Item settings (Keys/Compasses).