Home

Good to know

Render modes (F1)

hud.render-mode in config.yml:

• auto (default) - pages are drawn on a text display only the player can see, so F1 (hide GUI) doesn’t hide them. The editor is drawn both ways.
• display - everything on the text display. Survives F1; the vanilla hotbar, crosshair and held item draw over it.
• bossbar - everything in the boss bar row (the GUI). Hidden by F1.

Limits

• The HUD uses one boss bar row and must be the first boss bar. Other plugins’ boss bars move one row down.
• Pick a hud.bossbar-color that no other plugin uses for boss bars (its bar is made invisible by the pack).
• Text supports Latin letters (with accents) and common symbols. Use icons for everything else.
• Only Minecraft 1.21.11 clients get the HUD. Other versions (through ViaVersion) simply get no HUD.

Troubleshooting

• Nothing shows: run novaui license in the console. A locked NovaUI says why (no key, wrong key, no free seat…). See Licence & server seats.
• “License slot capacity maxed”: all seats of your key are used. Remove a server with /servers in our Discord.
• The pack doesn’t download: open port 8165 (or your http.port), or set http.public-host / http.public-port, or use pack.mode: external. /novaui selftest checks the download.
• Check everything at once: /novaui selftest.

Privacy

NovaUI only contacts our licence server (see Licence & server seats). The shipped profile menu shows Bedrock players a head picture from mc-heads.net, loaded by their game; set head-image: "" to turn that off.