UI & HUD Systems

Most UI is self-bootstrapping — managers create themselves at runtime via [RuntimeInitializeOnLoadMethod] and persist across scenes. No scene wiring required.

Self-bootstrapping managers

UI managers instantiate themselves at runtime and survive scene loads via DontDestroyOnLoad — no prefab or Inspector wiring. All of them are guarded client-only (the UNITY_SERVER guard).

SystemScriptBehaviour
ChatRodChatManagerNetworked (Mirror); Enter/T to open
ESC menuEscMenuResume / Logout / Quit; sort order 200
Who's OnlinePlayerListUIP to toggle; color-coded by class
NameplatesPlayerNameplateBillboard, distance-fade 20→40u; local hidden
GM consoleGmConsoleBacktick / F1; sort order 999 (see GM Console & Tools)
🛑 The canvas raycast rule

Every hideable canvas must set blocksRaycasts = false explicitly — alpha = 0 alone does not stop raycasting. An invisible canvas with a GraphicRaycaster makes IsPointerOverGameObject() return true forever and silently breaks camera orbit. This bit the project once already.

Combat HUD

  • Health bar green, shield absorb layered in blue on top.
  • Dodge pips — two squares; filled = ready, empty = recharging.
  • Ability slots — 6 (1/2/3/4/move/ultimate); greyed + countdown on cooldown, glow rim when ready.
  • Damage floats — white direct ¡ yellow crit ¡ orange condition ¡ green heal ¡ blue absorb; <5 dmg suppressed. (Rendered by FloatingDamageText — part of the game-feel layer.)
  • Condition icons under enemy nameplates (Burn, Slow, Suppress, Stagger, Exposed, Tethered).
â„šī¸ HUD art overhaul (2026-07-22 → 07-26)

The combat HUD moved from a plain bar layout to an authored health/mana orb + action-bar art frame. PlayerHUD.cs was reworked to drive a single PlayerHUD.png frame (which replaced the older ActionBarHealthManaCombo.png), and XpBar.cs was adjusted to fit under it. The bootstrapping model is unchanged — PlayerHUD still builds itself at runtime.

Camera

CameraFollow is a WoW/Smite-style orbit rig: cursor free by default, hold right mouse to orbit, _typingInUI suppresses orbit while typing. Full field reference, camera collision, the one-camera- per-zone rule, and the root-motion fly bug are documented in Player Movement, Camera & Controls.


Related: Player Movement, Camera & Controls ¡ GM Console & Tools ¡ Combat Core & Loop