Common Errors

What goes wrong most often, what it actually means, and what to do about it. Most of these are configuration, not faults. For anything about a button that should or should not be there, set Config.Debug = true, restart, open the wheel and read the F8 console: it prints every node it checked, the player's job and grade, and why each one was kept or hidden.

Installation and Access#

/radialedit does nothing

The server did not recognise the player as an admin, and it answers that silently. Check the routes in Claiming Admin Access: an ACE line added to server.cfg needs a server restart, and an identifier in Config.AdminIdentifiers must belong to the account that is actually in game. To see that account's identifiers, switch on Config.DevOpenEditor for a moment — the console prints them when they type the command.

Common Errors — Radial Menu | Quasar Store | Quasar Store

F3 does not open the wheel

Try /radial. If that works, the key is the problem: FiveM keeps each player's own binding, so a key changed in Config.OpenKey does not reach players who already have one, and another resource may use the same key. The player checks Settings → Key Bindings → FiveM → Radial Menu: Open. The key also does nothing while the pause menu is open.

The mouse cursor is stuck on screen

Press F10 or type /radialunstick. If it comes back, /radialreload reloads the whole interface. This mostly happens when the resource is restarted while a player has the wheel, the settings or the editor open.

A button or a section does not appear

In order of likelihood:

The player's job, gang or grade does not match. Grades are minimums, job names are exact, and a node with both a job and a gang needs both.
Its canInteract or one of its conditions returned false.
It is a section and none of its buttons are visible — empty sections are hidden.
The server runs standalone, so there are no jobs or gangs at all.
It is an item with no action — those are left out.

Config.Debug = true prints which of these it was.

Sections for scripts I don't have keep showing

Apartments, Laboratory and Motorhome decide whether to show by asking qs-apartments, qs-drugs-creator or qs-motorhome. When that resource is missing the question fails, and a section without a job or gang whose condition fails is shown rather than hidden. Delete those sections from config/menu.lua — or from the editor's tree.

My changes to config/menu.lua do not show

Either the resource was not restarted after the edit, or the editor's Override active is on — then its tree replaces the file entirely. Switch it off and save in /radialedit → Menu, or make the change in the editor instead. /radialeditdebug prints whether the override is active.

The Admin section never appears

The shipped Admin section shows when the player's qs_isAdmin state bag is true. Radial Menu does not set it — your admin resource does. If yours doesn't, replace the canInteract of that section with a job restriction, or with your own condition.

"Error executing action" or "Action not found"

Error executing action means the button's function failed; the notification carries the Lua error, which usually names a resource that is not running or an export that does not exist. Action not found means the menu changed while it was open — close and open it again.

A button does nothing at all

Its event or command has no listener: the resource behind it is missing, or the name is misspelt. Events are case-sensitive. A command is written without the slash — e wave, not /e wave.

Message	Means
`categoryId must be a non-empty string`	The first argument is missing, empty or not a string.
`category already exists: <id>`	That ID is taken — by your own earlier call or another resource. Prefix IDs with your resource's name.
`data table is required`	The second argument is missing.
`label (string) is required` · `icon (string) is required`	Both are mandatory on categories and items.
`parent not found: <id>`	No section has that ID. Create the parent first, or add `id` to the section in config/menu.lua. IDs are exact and case-sensitive — labels are never used.
`category not found: <id>`	`CreateItem` was given a section that was not created with `CreateCategory` — including one from config/menu.lua. Create your own section inside it and add the item there.
`action (function) OR event (string) is required`	The item has nothing to run. From another resource, a function does not count — use `event`.
`type must be 'command' \| 'qbcommand' \| 'server' \| 'client'`	`RegisterAction` without `fn` needs one of those four types.
`fn (function returning bool) required`	`RegisterPredicate` without a function — which is what happens when it is called from another resource. Register conditions in `custom/registry.lua`.
`action not registered: <id>` · `predicate not registered: <id>`	Unregistering something that is not there. Harmless.
`Not admin`	An editor save from a player the server does not see as an admin — for example after their admin rights were removed with the editor still open.
`Row <n>: …` · `Duplicate id at row <n>`	The Actions tab: that row is missing its ID, label or event, or repeats an ID.

Installation and Access#

Common Errors

Installation and Access#

The Wheel#

The Editor#

Appearance and Player Settings#

Error Messages#