Skip to main content

Troubleshooting

Every server notification shows with ×2​

Cause: the same notification arrives by two paths. On QBCore this happens when Config.HookQBCore = true while QBCore.Functions.Notify is patched: qb-core handles the QBCore:Notify event and so does this resource. On ESX the same happens with Config.HookESX = true next to the es_extended patch.

Fix: set the hook to false and restart. Config.DedupeWindow catches most of these, but only when both calls land within 150 ms.

Nothing shows​

  1. Run /gta6notify success. If a card appears, the resource works and the problem is the framework routing; check the installation patch.
  2. If nothing appears, check the F8 console for NUI errors and make sure the folder is named gta6_notify (the NUI ready callback and the export name rely on the resource name).
  3. Open the pause menu and close it again; the layer is hidden while the pause menu is active.

Cards appear behind another HUD or menu​

Config.ZIndex must be a number (default 99998) and the client must support SetNuiZindex (December 2024 or newer). On older clients the frame order follows the start order; start gta6_notify after the HUD resources in that case.

Cards are above a menu and steal its clicks​

Do not raise Config.ZIndex to 99999 or above. FiveM gives 99999 to the focused frame; anything above it takes the mouse.

No sound​

  • Config.Sound.enabled must be true and volume above 0.
  • The file must exist in html/sounds (the manifest includes html/sounds/*.ogg).
  • A call with sound = false is muted on purpose.
  • A merged duplicate re-plays the sound at most once per second.

es_extended errors at start about esx_notify​

es_extended requires a resource named esx_notify to exist. Keep the original esx_notify in [core] and use the one-line patch instead of renaming or replacing it.

Wrong type or colour​

Unknown type names fall back to info. Check Config.Types and Config.Aliases; the lookup is lowercase.

Text looks blurry in-game​

The NUI avoids backdrop filters and permanent transforms so the compositor keeps the text sharp, and it rounds font sizes to whole pixels. If you customise style.css, avoid adding backdrop-filter to .body or transform-based centring on the stacks.

Still need help?​