medium
likely
QBCore · AGN-KB-QB-0004
A QBCore callback never returns and the UI hangs
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.
A menu asked the server for information and never got an answer. Nothing on your PC causes this.
What you see
- A menu or action waits forever
- No error appears, which makes it harder to spot than a crash
- Often happens only under load, or only for some players
What usually causes it
- The server side of the callback threw before calling the callback function
- A database query inside the callback failed or timed out
- The callback name does not match between client and server
- Two resources registered the same callback name, and the later registration won
Worth checking first
- Check the server console for an error at the same timestamp
- Check whether it affects all players or one
- Check for duplicate callback registrations across resources
Safe steps, one at a time
- Player-side: note exactly which menu and which action, then report it
- Staff: check the server log at the timestamp before anything else — the silent failure is usually loud on the server side
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
- Which menu/action
- Timestamp
- Whether others are affected
- Server console excerpt
Last reviewed Fri Sep 18.