QWorlds 2.0.0 - The Modular Architecture & QTeams Update

QWorlds 2.0 is a complete ground-up refactor of the plugin codebase, transitioning the monolithic architecture into a clean, decoupled system (Managers, Listeners, Tasks, Models). This release introduces native cross-plugin integration with QTeams, the Orbital Strike Cannon relic, bulk lobby pre-generation, enhanced pathfinding for lobby minigames, and critical anti-dupe and math fixes.

---

What is New in 2.0.0

QTeams Ecosystem Integration

• Shared Network Hub GUI: Running /qw gui (or /qt gui) when QTeams is installed now opens a centralized Server Network Hub to navigate both plugins from a single dashboard. Admins can bypass directly to the QWorlds master panel with /qw gui master.
• Automated Squad Assignment: World queues now support squad routing (/qw open <world> [limit] [team]). Joining players are automatically placed into the specified team upon arrival in the target event world.

Relics, Arsenal & Minigames

• Orbital Strike Cannon Relic: Added a third ancient lobby relic. Players cast and reel in a custom fishing rod to call down 3 concentric rings of falling primed TNT (6, 10, and 14 entities) plus a center strike. Lobby block damage is disabled, player knockback velocity is reduced to prevent trolling, and strikes register hits on nearby minigame bats.
• Artifact Completion Cinematic: Collecting both the Treasure Trident and the Orbital Strike Cannon now triggers a custom celebration sequence with slot perimeter lightning strikes, goat horn sound effects, and an advancement challenge title banner.
• ParrotX2 Quiver Anti-Dupe: Hardened inventory handling around slot 17. Hand-swapping, inventory dragging, and cursor pickups with the locked relic arrow have been completely patched.
• Trident Loyalty Physics Fix: Corrected operator calculations in the loyalty void-recall check and chunk ticket assignment during long-distance throws.
• Clamped Bat Pathing: Personal lobby bats now strictly enforce line-of-sight raytracing from the player's eye level. Bats can no longer phase into solid walls, get trapped behind pillars, or fly above Y+1.55 (eye level).

Performance & Lobby Pooling

• Bulk Pre-Generation (/qw pregen <amount>): Added an asynchronous slot pre-generation worker. Lobby cells are built and cached ahead of time using chunk tickets and staggered pacing, completely removing TPS lag during sudden player join waves.
• Async Bounding Box Void Rescue: The cubic Bezier rescue arc now queries the active lobby template's bounding box and solid blocks. Players falling into the void sweep outward into clear airspace and climb 26 blocks above the highest solid block, ensuring custom roofs, overhangs, and barrier cages are fully cleared before touchdown.

Engine Refactor & Configuration

• Modular Codebase: Split the monolithic core into 12 dedicated classes across utility, model, manager, GUI, task, listener, and command layers for improved maintainability and lower overhead.
• Legacy Config Migration: Added an automated sanitizer on startup that detects and safely migrates legacy Bukkit Location serialization in config.yml without losing coordinates or saved session locations.

---

Upgrade Instructions

1. Stop your server.
2. Replace the old QWorlds.jar in your plugins/ directory with QWorlds-2.0.0.jar.
3. (Optional) Install QTeams to enable the shared network GUI and automated queue team assignments.
4. Start your server. Your existing config.yml, info_signs.yml, and custom_npcs.yml will automatically migrate to the new format.