HUD
Troubleshooting
Double HUD, missing hunger / thirst, minimap issues, server layout.
#Double HUD / overlapping widgets
Stop qb-hud / qbx_hud / esx_hud. If you start a category folder, move the folder out of resources/.
#Hunger and thirst are missing (ESX)
esx_status is required. Without a source the widgets are hidden on purpose (never fake values). On other frameworks you can feed them with exports.ghiaccio_hud:setStatus: see Commands, exports & events.
#Square / circle minimap falls back to rectangular
Both stream/ghud_*map.ytd and the PNGs in assets/minimap/ failed to load (an F8 warning shows it). Try Config.Minimap.masks = 'runtime', and check no other resource replaces the radar textures.
#Minimap border misaligned
Tune it with Config.Minimap.calibration and check other resources touching radarmasksm.
#The layout does not follow the player to another PC
Enable Config.DbSync = true in config_server.lua (needs oxmysql started before the HUD).
#Wrong clock
Check Config.Timezone (an IANA name, for example Europe/Rome); the console warns if the zone is not a known one. Config.TimeSource switches between server time and the GTA clock.
#Cannot publish the server layout
You need the ghiaccio_hud.admin ACE or a group in Config.AdminGroups (ESX: player group; QBCore / Qbox: permission; standalone: add_principal identifier.license:... group.admin, and if that is not enough add_ace group.admin group.admin allow).
#The HUD cannot be edited
Config.ServerDefault.locked = true makes the HUD editable only by admins.
#The editor does not open
Key conflict: use /hud. Or the character is not loaded yet.
#High resmon
Measure with resmon 1. The only per-frame thread is the native HUD hider: set Config.Features.hideNativeHud = false if you do not need it. Also stop any second HUD.
#Still stuck?
Send the console lines printed by ghiaccio_hud at start (framework and adapters) to support.