HUD Compatibility
ArenaPvP displays multiple HUDs during a match — arena timer, kill count, team scores, capture progress, and more. Since Hytale only supports one active HUD per player by default, ArenaPvP needs a way to layer multiple HUDs simultaneously.
This is handled automatically through a three-tier detection system that picks the best available approach on startup.
Detection Priority
When the server starts, ArenaPvP checks for HUD mods in this order:
| Priority | Mod | What it does |
|---|---|---|
| 1 (highest) | MultipleHUD | External mod that provides a native API for plugins to register multiple HUDs. Manages its own HUD groups, avoiding positioning conflicts with AutoMultiHud. |
| 2 | Built-in manager | ArenaPvP's own internal implementation (InternalMultiHud). Used when MultipleHUD is not installed. Compatible with AutoMultiHud. |
| 3 (fallback) | Built-in manager | Same internal implementation. Used when no HUD mod is installed at all. |
ArenaPvP detects installed mods automatically at startup. You don't need to configure anything — just install the mods you prefer and ArenaPvP adapts.
Built-in Manager
If MultipleHUD is not installed, ArenaPvP uses its own internal implementation (InternalMultiHud). It creates a single container HUD (#ArenaMultiHUD) and nests all arena HUDs inside it as groups, effectively combining them into one.
This option works out of the box with no additional mods required and is fully compatible with AutoMultiHud.
When Both Mods Are Installed
If both AutoMultiHud and MultipleHUD are installed on the same server:
- MultipleHUD takes priority — it is detected first.
- ArenaPvP routes all HUD calls through MultipleHUD's API.
- AutoMultiHud remains active in the background for other plugins that don't use MultipleHUD.
MultipleHUD is preferred because it manages HUD groups natively through its own API, avoiding the positioning conflicts that can occur when AutoMultiHud groups HUD packets by JAR source.
Reconnection and HUDs
When a player reconnects to a match, ArenaPvP rebuilds their HUDs from scratch. If AutoMultiHud is present, the plugin also clears any stale HUD state that AutoMultiHud may have cached for that player, ensuring a clean slate.
This prevents issues where reconnecting players might see broken or duplicated HUD elements.
Summary
| Setup | What ArenaPvP uses | Notes |
|---|---|---|
| No HUD mods | Built-in manager | Works out of the box |
| MultipleHUD only | MultipleHUD API | Recommended setup. Falls back to built-in if errors occur |
| AutoMultiHud only | Built-in manager | Compatible — all packets come from one JAR |
| AutoMultiHud + MultipleHUD | MultipleHUD API | MultipleHUD takes priority |