QWorlds v1.0.0 — Initial Release

QWorlds is a lobby virtualization, queue routing, and hub mechanics engine built natively for modern Paper and Purpur servers. Designed to eliminate multi-proxy network overhead for event organizers and content creators, it consolidates individual player instances into an isolated void grid while managing admission into active session worlds.

---

Core Systems & Architecture

• Virtualized Void Grid (qwlobby_hub):

  • Implements a coordinate-based grid partition system (10 columns with 256-block spacing along X and Z axes at Y-64).
  • Enforces localized view and simulation distances (5 chunks) and tablist culling, completely isolating player audio, visuals, chat, and entity loading between active slots.

• Asynchronous Pre-Generation Pool:

  • Uses chunk ticketing and template caching to stamp saved structures across unallocated coordinates in advance.
  • Instant player assignment on join with zero main-thread TPS degradation.

• Collision-Proof Void Rescue Arc:

  • Cubic Bezier trajectory captures players falling below Y-44 and smoothly returns them to platform spawn without jarring instant teleports.
  • Calculates platform perimeter vectors to sweep the player horizontally into open airspace before climbing 26 blocks above the highest solid block, preventing collisions with roofs, overhangs, or decorative geometry.

• Sign-Free Directional Holograms:

  • Physical signs placed in the build world act strictly as coordinate anchors and are cleared upon template stamping.
  • Spawns native TextDisplay entities set to Billboard.FIXED, locking yaw rotation directly to the sign's original orientation with centered text alignment.
  • Features an invisible Interaction hitbox entity that detects player right-clicks and dispatches configured URLs (info_signs.yml) directly to chat as clickable MiniMessage prompts.

• Interactive Relic Loadouts:

  • Bow of ParrotX2: Infinite-ammo utility weapon with explosive particle impacts and zero environmental damage. Automatically equips and locks a dedicated quiver arrow into slot 17.
  • Treasure Trident: Custom loyalty trident featuring cosmetic lightning strikes, chunk ticketing for extreme distance throws, and instant recall failsafes upon falling into the void.
  • Orbital Strike Cannon: Fishing rod mechanism with a 3-second cooldown. Reeling in summons 3 concentric rings of primed falling TNT (6, 10, and 14 entities) plus a center strike, with a 75% reduction in player explosion knockback.
  • Artifact Completion Cinematic: Claiming both the Treasure Trident and Orbital Cannon triggers an 8-strike perimeter lightning sequence, goat horn audio, and an advancement challenge title banner.

• Line-of-Sight Bat Minigame:

  • Spawns slot-bound bats clamped between Y+0.2 and Y+1.55 (under eye level) at a maximum 45-degree angle.
  • Every waypoint destination runs a block raytrace from the player's eye location, guaranteeing bats never fly behind solid walls or obstructions.
  • Features escalating note block pitches on consecutive hits and a 10-streak combo finale that sequentially detonates all remaining bats in the slot.

• Reflection-Based FancyNpcs Integration (custom_npcs.yml):

  • Integrates with FancyNpcs via Java reflection, requiring no hard Maven dependencies and preventing server crashes if the plugin is absent.
  • Custom player NPC presets can be declared in custom_npcs.yml and spawned via /qw spawnplayer <id>.
  • The /qw removenpc command searches both tracked active instances and untracked FancyNpc managers to cleanly purge nearby queue NPCs and player NPCs within 4 blocks.

• Administrative Controls & Session Routing:

  • Interactive control panel GUI (/qw gui) and setup checklist book (/qw guide).
  • Automated queue states (OPEN, RECORDING, CLOSED) with custom admission quotas and automatic session locking.
  • In-game template creation tool (/qw wand, /qw savetemplate, and /qw setpedestal).
  • Moderation suite featuring lobby-based player bans (/qw lobbyban), staff lobby spectating (/qw lobbylist, /qw lobbytp), and forced player evacuations.

---

Platform Requirements

• Server Implementation: Paper or Purpur (1.20.6 / 1.21+)
• Java Runtime: Java 21 or higher
• Dependencies:
  • FancyNpcs (enables player models and skin fetching)
  • Multiverse-Core (enables automated world creation and importing via commands)