The Echo Warden - Boss

[1.0.1] - 2026-04-25

Persistence & Restoration Stability (The "Underwater Fix")

Added

• Y-Coordinate Persistence: The boss now saves its exact vertical position (GLOBAL_WARDEN_Y) to EchoWardenState.txt.
• Restoration Teleportation: When the boss is restored from disk or chunk reload, it is now forcefully teleported to its exact saved X, Y, and Z coordinates.
• Restoration Grace Period: Added a 3-second "Lock" period during restoration spawns to prevent gravity or wandering from displacing the boss before the client and Fly controller are ready.

Fixed

• Fixed a bug where the Echo Warden would spawn underwater or inside terrain if its chunk was reloaded while it was flying.
• Fixed a horizontal "drift" of ~20 blocks that occurred during the engine's default restoration pass.

Multi-Backend HUD & External Mod Compatibility

Added

• Multi-Backend HUD Factory: Implemented BossBarHudBackendFactory to intelligently select the best rendering method for the boss bar.
• MultipleHUD Support: Added native support for Buuz135:MultipleHUD via a reflection-based bridge.
• AutoMultiHud Support: Added support for AutoMultiHud:AutoMultiHud (Dairymoose), using the native HUD path for client-side multiplexing.
• Other HUD mods: Fully restored compatibility with other HUD mods. The boss bar no longer overwrites or crashes the client when these mods are present.

HUD Toggle & Clarity

Changed

• Documentation now clearly states that the boss bar uses Hytale server CustomUIHud and does not require the community HyUI mod.
• Reworded README sections to clarify the likely crash source in heavy modpacks (multiple mods touching the same custom HUD path).

Added

• Persistent setting bossBarCustomHudEnabled (stored in EchoWardenState.txt) to disable only the custom boss bar without affecting combat logic.
• New admin command /echowardenbossbar with on|off toggle to control custom HUD at runtime (no restart required).
• CurseForge host reply draft for HyUI/custom HUD crash reports under Branding/CurseForge-reply-hyui.md.

Technical Notes

• When custom boss bar is disabled, EchoWardenBossBarSystem skips setCustomHud updates and performs a cleanup pass to clear active bars safely.
• Quick SDK/JAR review found no obvious public "vanilla boss bar" API equivalent for this NPC flow in the current server version; OFF mode remains the practical fallback.

Special Thanks

Big thanks to chaoticreaper_ for sending the logs and doing the testing, and to sigyn_laufeyson for helping isolate the MultipleHUD conflict. I really appreciate the help!