GhiaccioScripts

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.