AGN Troubleshooter
FiveM · GTA V support

← Error library

high confirmed Resource / UI · AGN-KB-UI-0001

Stuck NUI focus — cursor locked, cannot move, cannot type, menu will not close

A menu kept control of your mouse and keyboard. Relogging frees it. Telling us which menu is what stops it recurring.

What you see

  • A mouse cursor stays on screen and the character will not respond
  • Typing goes nowhere, or into the menu
  • Escape does not close it

What usually causes it

  • A UI took keyboard/mouse focus and an error stopped it releasing focus
  • The close path was gated on another action succeeding, so a failure left the UI open
  • A browser dialog (confirm/alert/prompt) inside the UI, which freezes the whole in-game browser until the player relogs

Worth checking first

  • Ask which menu or resource was open
  • Ask whether Escape does anything at all
  • Ask for the F8 text if the console can still be opened

Safe steps, one at a time

  • Player-side: relogging clears it. Note which menu it was first — that is what lets us stop it happening again
  • Staff: check the resource's close path for a condition that can fail before focus is released
  • Staff: a native confirm/alert/prompt inside NUI traps the player until relog and cannot be escaped from Lua, because the UI holds the keyboard. Replace with an in-page modal

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

Escalate every occurrence with the resource name. It is a trap-the-player bug, which is worse than a feature not working.

Looks like

AGN resource / QBCore

What staff will need

  • Which menu or resource
  • What action preceded it
  • Whether Escape responded
  • F8 text if available

Applies to

Record the resource and its version.

Last reviewed Fri Sep 18.

Source documentation