QWorlds 2.1.0 - The Modular Architecture, Death Routing & QTeams Update

QWorlds 2.1.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, a 4-mode player death routing selector, customizable relic names via relics.yml, the Orbital Strike Cannon relic, and bulk lobby pre-generation.

---

What is New in 2.1.0

1. 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.

2. 4-Mode Player Death Behavior Selector

• GUI & Command Control (/qw deathmode): Added a Death Behavior selector in both the Main Control Panel GUI (Slot 52) and per-world Editor GUI (Slot 18).
• Four Selectable Modes:
  1. Lobby + Left Msg: Shows death message, broadcasts <Player> left the game, and sends the player to their void lobby.
  2. Stay in Game + Left Msg: Shows death message, broadcasts <Player> left the game, and keeps the player inside the recording world on respawn.
  3. Just Kick (No Lobby) + Left Msg: Shows death message, broadcasts <Player> left the game, and kicks the player from the server.
  4. No Death Msg + Kick Only: Hides the death message completely, broadcasts <Player> left the game, and kicks the player from the server.

3. Relics Configuration (relics.yml) & Arsenal Updates

• Custom Relic Names & Gradients: Added relics.yml to customize the display names, hex color gradients, and quiver arrow names for all three relics. Running /qw reload dynamically updates active items in online players' inventories and across lobby pedestals.
• 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 with zero block damage and reduced recoil.
• Artifact Completion Cinematic: Collecting both the Treasure Trident and the Orbital Strike Cannon triggers a slot perimeter lightning sequence, goat horn sound cues, and an advancement challenge banner.
• ParrotX2 Quiver Anti-Dupe & Trident Physics Fix: Patched inventory hand-swap/drag duplication around slot 17 and restored operator calculations in the loyalty void-recall check.

4. Performance & Lobby Pooling

• Bulk Pre-Generation (/qw pregen <amount>): Added an asynchronous slot pre-generation worker using chunk tickets and staggered pacing to eliminate TPS drops during join waves.
• Async Bounding Box Void Rescue: The cubic Bezier rescue arc now dynamically queries the active lobby template's bounding box so players clear custom roofs, overhangs, and barrier cages before touchdown.
• Clamped Bat Pathing: Personal lobby bats now enforce line-of-sight raytracing from eye level and cannot fly above Y+1.55.

---

Upgrade Instructions

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