medium
likely
Resource / UI · AGN-KB-UI-0002
A UI is blank, or its buttons do nothing (JavaScript error in NUI)
This one is not certain. It is marked likely: the guidance is safe and reasonable, but the diagnosis is not proven for every case. If it does not match what you are seeing, stop and ask rather than pushing on.
The menu's page loaded but the information it needed did not arrive in the form it expected. Server-side.
What you see
- A menu opens empty, or a section of it never renders
- Buttons do nothing at all
- Other players may see the same
What usually causes it
- The data sent to the UI has a different shape than the page expects
- An empty Lua table serialises to a JSON array, so a map arrives as [] and every named property is silently lost
- A template calling a method where a computed value is expected renders nothing, with no error
- A missing asset file in the UI bundle
Worth checking first
- Ask whether it is empty for everyone or just this player
- Ask for the F8 console text
- Check the message shape the resource sends against what the page reads
Safe steps, one at a time
- Player-side: report which menu, and the F8 text if you can get it
- Staff: check the payload shape first — nested versus flat message shapes differ between AGN resources and getting it backwards fails silently
- Staff: an empty table encoded as [] rather than {} is a recurring cause; serialise explicitly
These are suggestions, not instructions. Do only what you are comfortable with, back up anything important first, and stop if a step does not match what is on your screen. Advice, risk and responsibility.
When to stop and ask staff
Always staff.
Looks like
AGN resource / QBCore
What staff will need
- Menu/resource name
- F8 console text
- Whether everyone sees it
- Steps to reproduce
Last reviewed Fri Sep 18.