FAQ

Does it work with ESX, QBCore and QBox?

Yes. It auto-detects ESX, QBCore, QBox, ox_core and vRP, and runs fully standalone. The citizen file is normalised from whichever core you run, with no hard coupling.

Yes. Escape opens HZ-PauseMenu instead of the stock Rockstar menu. The native GTA V Settings screen is still reachable from a card — and it gets recoloured to your accent.

Do I need hz_lib?

Yes. hz_lib is free and required: the menu loads its UI kit, fonts and theme colours from it, and its settings appear in /hzpanel. Without hz_lib the resource still starts, but the menu opens unstyled. Start hz_lib before hz_pausemenu.

Does it need a database?

No SQL table. Player settings (graphics, crosshair) live in client KVP per machine, with no server round-trip.

Does it depend on ox_lib?

No. Callbacks are self-contained, so it does not need ox_lib — it stays compatible if you already run ox_lib.

My profile shows "--" for a field. Is that a bug?

No — your framework simply doesn't expose that field. Base ESX has no nationality, for example; Config.DefaultNationality fills it. Fields that genuinely don't exist on your core stay blank rather than showing wrong data.

Is the crosshair colour picker really unlimited?

Yes. Beyond the preset swatches there is a full HSV picker (saturation/value pad, hue slider, hex field), so players can dial in any colour, save it as a custom preset and keep it between sessions.

Point Config.Hud at your HUD resource — it works with any of them via event, export or a custom function. See HUD integration.

What if my server has no multi-character system?

Leave Config.LogoutCommand empty. The character card then stops offering "change character" and opens the PROFILE tab instead — no dead button, no misfired command.

Is it heavy?

No. It sits around 0.06 ms idle — about 0.4% of a single 60 FPS frame. The only always-on cost is the per-frame input capture that redirects Escape, which every pause-menu replacement pays.

Is there a build step?

No. The interface ships pre-built — no Node.js, no npm install. Drop it in, ensure, reconnect.

FAQ