HUDRouter

HUDRouter

HUDRouter was created as a modern alternative to MultipleHUD, with a focus on cleaner architecture, easier extensibility, and full backward compatibility.

What it does

Hytale only allows one custom HUD per player. If you have multiple mods that each want to display their own HUD (like AscendRPG, BetterMap, EasyHunger), only the last one wins. HUDRouter combines them all into a single HUD so every mod can display its UI at the same time.

Installation

1. Download HUDRouter-X.X.X.jar from Releases
2. Place it in your UserData/Mods/ folder
3. Remove MultipleHUD-x.x.x.jar if you had it
4. Done - no config needed, all existing mods work automatically

For Developers

Existing MultipleHUD mods

No code changes needed. HUDRouter includes a compatibility shim - all MultipleHUD.getInstance().setCustomHud() calls work automatically.

New mods (reflection - recommended)

All API methods are static. No compile-time dependency needed:

try {
    Class<?> router = Class.forName("com.hudrouter.HudRouterPlugin");
    Method setHud = router.getMethod("setChannelHud",
        Player.class, PlayerRef.class, String.class, CustomUIHud.class);
    setHud.invoke(null, player, playerRef, "MyMod", myHud);
} catch (ClassNotFoundException e) {
    // HUDRouter not installed - fall back
    player.getHudManager().setCustomHud(playerRef, myHud);
}

Available static methods

// Register / update
HudRouterPlugin.setChannelHud(player, playerRef, "MyMod", myHud);
HudRouterPlugin.setChannelHud(player, playerRef, "MyMod", myHud, 10); // with priority

// Remove
HudRouterPlugin.removeChannelHud(player, "MyMod");

// Query
HudRouterPlugin.getActiveChannels(player);
HudRouterPlugin.hasChannel(player, "MyMod");
HudRouterPlugin.getChannelCount(player);

Optional manifest entry

{
  "OptionalDependencies": {
    "com.hudrouter:HUDRouter": "*"
  }
}

Contributing / Source

The full source code is available on GitHub:

https://github.com/Alien4042x/Hytale-HUDRouter-Mod

If you want to improve the router, fix bugs, or extend functionality, feel free to open an issue or pull request.