Endgame & QoL - 5.0 Out !

[5.0.0-3]

> ⚠️ Delete Config_Endgame&QoL/EndgameConfig.json before first launch. The config schema was rewritten — old 4.x files silently drop the new sections. Progress, pets, pouch and leaderboards are safe (stored in ECS). > > 🛠️ This is a starting point, not a finish line. Everything ships with active tuning planned — Eldergrove + Canopy re-enable, the 3 remaining pet SS auras, mount anchors, drop rates. Bug reports with client logs land patches within hours.

New Features

Void Realm (new dimension)

• Floating island arena in the void, home of the reworked Golem Void boss.
• Entry via Void Realm Key (renamed from "Shard of the Void", auto-migrated).
• Dedicated combat music plays throughout the dimension.
• Void-Fall rescue — falling off the island teleports you back to the center. Zero death penalty.

Void Gauntlet

• 3-wave survival trial inside the Void Realm before facing the Golem Void.
• No leash fail.

Temporal Portal System

• Random portals spawn near players every 5-10 min, leading to temporary dungeon instances.
• Lifetime stages : STABLE → DESTABILIZING → CRITICAL → COLLAPSING.
• Respects OrbisGuard / SimpleClaims.
• 3 themed instances — Eldergrove Hollow, Oakwood Refuge, Canopy Shrine. Each has 3 tiered loot chests (Common / Rare / Hidden), its own skybox + weather.
• Only Oakwood Refuge is live at launch — Eldergrove + Canopy re-enable in a patch within the coming days.

Oakwood Warlord (new elite)

• 1,000 HP revenant warlord guarding the Oakwood Refuge instance.
• 3-attack chain : Triple Strike (3× 25 melee), Scepter Shot (3-orb purple barrage), Ground Slam (60 AOE with purple telegraph).
• Death-spawns a 400 HP withered husk minion.
• Drops 2–4 Mithril Bars guaranteed + Voidheart / Adamantite. 300 XP reward.

Pet Companion System

• 4 boss pets : Dragon Frost, Dragon Fire, Golem Void, Hedera. 10-15% drop from their parent boss.
• 6 tiers (D → SS) via feeding.
• Tier C : mount unlocked (dragons only; Golem Void mounts at S; Hedera non-mountable).
• Tier S : passive perk on the owner (Ice / Fire / Physical resistance, Poison immunity).
• Tier SS : aura effect. Only Golem Void's Void Barrier is live at launch — Frost Aura / Immolation / Nature's Blessing land in a follow-up patch.
• /eg pet UI.

Endgame Gateway block — themed portals

• One craftable portal block, three destinations.
• Right-click with an Endgame key and the gateway retheme itself :
  • ❄️ Frozen — cyan frost glow → Frozen Dungeon
  • 🌿 Swamp — green moss → Swamp Dungeon
  • 🟣 Void — purple runic → Void Realm
• Each theme has its own particle VFX, glow color, activation sound.
• Breaking any variant returns the base Gateway — the block is never lost.
• Vanilla Portal_Device rejects Endgame keys with a chat redirect.

Dragon Frost rework (3 HP phases)

• Phase 1 (>70% HP) — flying, melee-immune. Frost Bolt barrage + new Icy Wind radial gust.
• Phase 2 (70-40% HP) — grounded, projectile-immune. Melee + Stomp + new Frost Breath cone.
• Phase 3 (<40% HP) — cycles fly/ground every 8-10 s, alternating immunity, all attacks enabled.
• One-time chat hint when a player hits with an immune damage type.

Hedera rework

• 3 new attacks : Vine Grab (pull, P2+), Ground Slam (AOE + Stagger, P2+), Charge (lunge, P3).
• Lingering poison clouds every 18-25 s during P2+.

Golem Void — Jump Slam signature

• New signature unlocks at Phase 2, ramps at Phase 3.
• Telegraphed teleport-and-crash : 80 Physical AOE + 1 s Stagger.
• Void-safe fallback if players bait the boss off the island.
• Knockback-immune, MaxSpeed 14.

UI

• Boss bar redesign — rebuilt HyUI bar shared by all bosses + elites. Per-boss color fill, glossy overlay, gold phase markers, numeric HP, INVULNERABLE / ENRAGED badges.
• Proximity display — HP bar shows within 50 blocks, hides at 55 (hysteresis). No damage required.
• Native Journal Page — Bounty Board, Bestiary and Achievements unified in one page. Paginated mob cards, kill milestones, discovery badges. Localized in all 5 locales (en-US, fr-FR, es-ES, pt-BR, ru-RU).
• Custom Trade UI — item icons, affordability coloring, stock display, purchase notifications on all 3 merchants.
• Snake Arcade rework — native WASD controls, speed indicator, eat flash, domino death animation.

Misc

• Warden Trials blocked in instances — can't be started inside dungeon instances.
• Spear pickup after throw — thrown spears drop as pickable items at the landing point (100% return).
• Endgame Memories — custom "Endgame" category in Bench Memories. 19 NPCs.
• Item ID Migration — auto-converts stale item IDs on connect / chunk load.
• Developer API — endgame.bossbar.* + endgame.wavearena.* packages with zero plugin imports. Cross-mod BossBarFocus coordinator.

Balance

• Prisma Daggers — signature Razor Storm (100 SE, 3 AOE bursts = 240 dmg). Ability3 Prisma Dash (60 Mana, 10-block lunge, 80 dmg).
• Prisma Sword — signature Prismatic Judgment (100 SE, 10-block AOE slam, 250 dmg + knockup + slow). Ability3 Prismatic Beam (80 Mana, 20-block projectile + AOE).
• Frostbite Blade — signature Blizzard Stance (100 SE, 3 mobile pulses = 240 Ice, final freezes). Ability3 Ice Field (50 Mana, 3 slow pulses).
• Boss XP cap — raised from 100 k to 1 M for high-level integrations.
• Accessory tooltips — Accessory — store in trinket pouch marker across all 6 accessories, 5 locales.

Removed

• Gauntlet system — infinite-wave arena removed (was disabled by default). Replaced by the Void Gauntlet in Void Realm.

Config Changes

• Native Config UI — rewritten in native .ui with 8 tabs : Difficulty, Scaling, Weapons, Armor, Crafting, Misc, Integration, Addons. Global search + recipe editor.
• Full config coverage — every live knob now exposed in /eg config (no restart needed) :
  • Difficulty — Boss Damage Player Scaling (opt-in; HP still scales 50% per extra player).
  • Scaling — Enrage system (toggle + threshold / window / duration / multiplier / cooldown) + Golem Void phases (P2/P3 thresholds, invulnerability, minion counts, danger zone) + per-boss XP rewards for all 9 bosses/elites.
  • Weapons — Hedera Boss Poison (damage + ticks).
  • Misc — Portal advanced (spawn distance, grace period, announce radius) + Frost Dragon tuning + Combo multipliers (x2 / x3 / x4 / Frenzy) + Warden Trial tier timers + Boss Target Switch + Shared Kill Credit + Accessories toggle + Minion Spawn Radius + Eye of Void HP multiplier + Pet tuning (4 unlock chances + teleport distance).
  • Integration — EndlessLeveling tuning + OrbisGuard action blocks.
• Temporal Portal field labels clarified — plain-language hints next to each portal knob.
• /eg status redesign — larger panel, Integrations card, Uptime, Active Encounters dashboard (live data : boss breakdown, trial count, portal dungeons, instance world count, bounty players, spawned pets). 3 more feature toggles (Temporal Portals, Pet System, Vorthak).
• MultipleHUD integration — soft-dependency with Buuz135's MultipleHUD mod. Combo Meter + Wave HUD register under named IDs so they coexist with other mods' HUDs. Falls back to vanilla if missing.
• Unified commands — all under /eg : config, admin, pet, journal, status, lang.
• LuckPerms compatibility — player commands use default-allow permissions.
• Integration auto-detection — RPG Leveling, Endless Leveling, OrbisGuard auto-enable on presence.

Bug Fixes

• Staff direct-hit death animation — 9 staff projectiles (Copper → Onyxium + Mithril Heavy) converted to modern ProjectileConfig. Fatal direct hits now trigger the death animation and impact FX.
• Frozen / Swamp Dungeon chest loot — prefabs re-authored. Chests now use proper tiered DropLists so loot rotates.
• Frostwalker waterlogged blocks — ice no longer replaces solid blocks.
• OrbisGuard dungeon chests — chest/door/light access flags added inside protected instances.
• Trinket Pouch only worked in hotbar — now scans the full inventory.
• RPGLeveling config override — no longer overwrites RPGLeveling's config on startup.
• AccessoryAttackSystem crash — Ref validity check on burn apply.
• Prisma 3x3 drops lost — surrounding blocks now drop as world items.
• Boss kill sound — only plays for the killer.

Technical

• CAE (Combat Action Evaluator) — Void Golem + Frost Dragon use the vanilla CAE for attack selection (distance-aware, cooldown-gated, HP-phase-gated). 12 new Root_NPC wrappers, 2 CAE assets, new Template_Endgame_Dragon_Frost.
• Unified boss manager framework — ~700 lines of duplicate code removed. All bosses flow through GenericBossManager with pluggable phase callbacks. endgame.bossmanager.* package seeded for extraction.
• Status effects consolidation — 5 custom effects replaced with vanilla equivalents. New Endgame_Stagger (1 s stun) on heavy AOE boss attacks.
• NPC asset reorganization — semantic directories (Bosses/, Endgame_Mobs/, Frozen_Dungeon/, Swamp_Dungeon/, Void_Realm/).
• Full HyUI → native .ui migration — all pages. HyUI only for boss bars.
• Combo meter — migrated to native CustomUIHud.
• SimpleClaims compatibility — Prisma 3x3 + portal spawning respect claims.
• Dependency updates — EndlessLeveling 7.9.4.
• Prefab optimization — all 6 endgame prefabs passed through PrefabOptimizer for ~80% size reduction, sub-second loads on SSD.
• Per-UUID disconnect cleanup — per-player state maps key off UUID with explicit eviction. Prevents session-scale heap growth.
• PlayerRefCache race fix — register/unregister compound ops atomic. Fallback scan snapshots the player list before iterating.
• Cross-dimension HUD cleanup — AddPlayerToWorldEvent is the authoritative clear hook. HUD clear packet sent directly via PlayerRef.packetHandler.
• Admin command safety — /eg admin reset bounties requires 30 s confirmation. Destructive admin actions logged to EndgameQoL.AdminAudit.
• Config hardening — recipe overrides clamp CraftTime [0.1, 120], Quantity [1, 64], BenchTier [0, 5]. Database config regex-validates JDBC URL + clamps pool size.
• Safe world-thread scheduling — new SafeWorldExecute utility logs drop-before-exec gaps.
• BossBarHudManager extracted — HUD lifecycle split out of GenericBossManager.
• WaveArena framework — Warden Trials + Void Gauntlet run on a generic data-driven wave engine (extractable). Public WaveArenaAPI.
• Portal theme revert — shutdown race guarded — PortalThemeTracker.onWorldRemoved skips block revert when the server is shutting down. Eliminates IllegalMonitorStateException WARN spam.