☰

Waila / Hwyla Installed on Server

Waila or Hwyla (a 'what am I looking at' HUD mod) was installed on a server and caused issues. These mods render an information overlay on the client and are client-only.

What does this error mean?
Waila/Hwyla (and successors like Jade) display a HUD tooltip about the block/entity you look at. That overlay is drawn by client rendering, so on a dedicated server the mod has no rendering to attach to and should not be installed there. 
HUD overlay mod (client-only)
Most Common Causes
  • The HUD mod jar placed in the server mods folder.
  • Copying client HUD mods to the server.
  • Assuming the overlay needs a server component.
  • A pack including it in the server set.
  • Mirroring the client mods folder.
How To Diagnose
  1. Confirm the crash/error relates to the HUD mod and client rendering.
  2. Check the server mods folder for Waila/Hwyla/Jade.
  3. Recall these are client-side HUD overlays.
  4. Look for other client-only mods.
Recommended Fixes
  • Remove the HUD mod
    Delete Waila/Hwyla from the server, players run it on their clients.
  • Add only a server provider if needed
    Some HUD ecosystems have optional server-side data providers, install just that piece if a mod requires it.
  • Keep HUD mods client-side
    Information overlays are client UI and belong on the client.
  • Audit client mods
    Remove other client-only HUD/overlay mods from the server.
Analyze My Log
Frequently Asked Questions

Yes, on each player's client. The HUD mod just must not be on the server.

Usually not, though some HUD providers ship an optional server companion for extra data.

Jade is the modern successor, all are client-side HUD overlays with the same server caveat.