Troubleshooting guide

QBCore Job Menu Not Opening? Fix Duty, Target and Permissions

When a QBCore job menu does not open, the issue is usually duty state, target-zone setup, grade checks or a client event that never fires.

Updated September 2026 · 7 min read · Stellar AI
Use this Stellar prompt:

“My QBCore job menu will not open. Check job name, grade, duty state, target setup, event names, dependencies and server permission checks. Give me the smallest safe patch and a test plan.”

Debug my job menu →

Confirm the player state first

A job menu can fail for a simple reason: the player is not the job, not on duty, not the required grade or not close enough to the target zone. Before changing UI code, print or inspect the current player job data. Check the job name, grade level, duty flag and any gang or department state the menu expects. If the menu is for police, ambulance, mechanic or real estate, compare the job name in the script with the job name configured in QBCore shared jobs.

Do not remove job checks to make the menu appear. That creates a bigger issue because any player may be able to open staff tools, society actions or restricted shop flows. The right fix is to align the configured job name, grade and duty state with the intended menu. If your server uses multijob or custom duty logic, mention that in the debugging prompt because the menu may be reading the wrong active job source.

expected job:
actual player job:
required grade:
on duty true/false:
target resource:
client event name:

Check target and command entry points

Many QBCore menus open from qb-target, ox_target, a keybind, a command or a marker. If the UI never appears, work backwards from the entry point. Does the target zone exist? Is the resource that creates the zone started? Is the interaction distance too small? Is the event name spelled the same in the target option and the client event handler? If the menu opens through a command, check command registration and permission requirements.

Target problems can be silent. The script may start with no console error, but the player never sees an interaction. In that case, add a temporary debug print at the target setup and event handler. If setup prints but the event never prints, the target or interaction is the problem. If the event prints but the UI does not open, the problem is likely the menu library, context registration, NUI focus or missing dependency.

Match your menu library

QBCore job menus can use qb-menu, ox_lib context menus, custom NUI or a framework-specific UI. Do not mix examples without adapting them. An ox_lib context menu requires different registration and display calls than qb-menu. A custom NUI may need focus handling and message events. If you ask AI to fix it, include which menu library you actually want to use. Otherwise the patch may convert your menu to a different library and break the rest of your resource.

Keep the server authoritative

Opening a menu is client-side, but important actions behind that menu should still be checked on the server. Billing, impounding, reviving, cuffing, evidence, stash access, boss actions and inventory changes should validate job, grade, duty and target state server-side. If a fix only hides or shows buttons on the client, it is not enough. A player who can trigger an event manually may still bypass the visible menu.

After patching, test correct job, wrong job, off-duty state, low grade and missing dependency. Test on a fresh restart, not only after resource refresh. A job menu is stable when it opens for the right people, stays hidden from the wrong people and all server actions reject invalid requests.

Fix the menu safely

Paste the job config, target setup, menu code and console output into Stellar AI. Ask for a patch that keeps duty and grade checks intact.

Open Stellar AI free →