QBCore Frameworkqbcore.netCommunity docs
On this page

Updated 2026-10-13 · 4 min read

qb-radialmenu

qb-radialmenu presents a wheel of contextual actions. Each entry describes an action; another resource still has to implement its event. This guide builds a harmless help action with a complete client resource, so you can test the handler independently before adding it to the wheel.

Baseline: 3fa42401. See its config, README and manifest. The manual checks below have not been executed in FiveM by this article.

Radial menu, qb-menu or qb-target?

NeedResource
A wheel of commonly used player actionsqb-radialmenu
A list of actions or a conventional submenuqb-menu
Interaction with an entity or zoneqb-target
Fields the player must fill inqb-input

Do not install multiple replacements for the same interaction just to solve a missing handler. Identify the responsible resource first. Keep the wheel focused on actions players actually use.

Configure the keybind and opening behavior

The pinned config defaults to Config.Keybind = 'F1', Config.Toggle = false and Config.UseWhilstWalking = false. With toggle disabled, use the configured hold-to-open behavior rather than expecting a single tap to keep the wheel open.

The key is registered through FiveM keymapping. Changing the server-side default does not necessarily overwrite a player's saved binding. Check Settings → Key Bindings → FiveM and the keybinding guide before repeatedly changing Config.Keybind.

Icon references can differ between documentation, README and frontend revisions. The pinned README mentions Font Awesome 5, while the documentation source describes support through 6.1.1. Inspect the assets actually loaded by your installed frontend instead of assuming every icon from the newest catalog will work.

Add one client-side action

Create resources/[local]/qbnet-help/ with the following files. This resource displays a notification and makes no server request.

fxmanifest.lua

fx_version 'cerulean'
game 'gta5'
client_script 'client.lua'
dependency 'qb-core'

client.lua

local QBCore = exports['qb-core']:GetCoreObject()

local function showHelp()
    QBCore.Functions.Notify('Use the server help page for commands.', 'primary', 5000)
end

AddEventHandler('myhelp:client:show', showHelp)
RegisterCommand('qbnet-help', showHelp, false)

The event is local because the configured wheel action is a client action. There is no need to expose a network event just to show this local message. Notification usage is described in QBCore functions.

In the server console, run refresh and ensure qbnet-help. In in-game chat, run /qbnet-help. First expected result: one help notification. If that fails, diagnose this resource and qb-core before changing the radial menu.

Then add the following entry inside the existing Config.MenuItems array in qb-radialmenu's config.lua:

{
    id = 'local_help',
    title = 'Help',
    icon = 'question',
    type = 'client',
    event = 'myhelp:client:show',
    shouldClose = true
},

This is a table entry, not a standalone Lua file. Do not replace Config.MenuItems with it or duplicate an existing ID. The manifest/client files belong in qbnet-help; the entry belongs in qb-radialmenu. Apply the config change on staging and test the wheel with its configured binding.

Second expected result: selecting Help closes the wheel and displays the same single notification. The independent command separates a missing handler from a menu-configuration problem.

Add a submenu without breaking dispatch

A parent entry uses an items array containing child entries. Keep the parent and child IDs unique, and put the type, event and shouldClose fields on the actionable child:

{
    id = 'local_information',
    title = 'Information',
    icon = 'info',
    items = {
        {
            id = 'local_information_help',
            title = 'Help',
            icon = 'question',
            type = 'client',
            event = 'myhelp:client:show',
            shouldClose = true
        }
    }
},

Use either the single entry or this submenu during your initial test, not both copies. The structure follows the documented menu format.

For state-changing gameplay actions, the menu only requests an operation. Implement permissions and current-state checks on the server; a hidden wheel option is not authorization. See safe server events.

Troubleshooting

SymptomIsolating check
F1 does nothingInspect saved binding, hold/toggle mode, movement restrictions and first Lua error
Help appears but does nothingRun /qbnet-help; compare the event string and type = 'client'
The command works but the wheel does notInspect the entry's placement, unique ID and loaded config
An icon is blankInspect the icon assets/classes in the installed frontend
A role-specific option is absentCheck live job, duty and context conditions, not just the job label
Menu stays open or controls remain capturedVerify close handling and the selected action's behavior

Trunk-door changes and runtime boundary

The current server/trunk.lua adds player-ped, nearby-vehicle, matching-plate and two-unit proximity checks before broadcasting qb-radialmenu:trunk:client:Door. This is a change from the older pinned handler, which broadcast the supplied plate and door arguments directly. It still needs argument validation and an actual server-artifact test. The same file imports only Functions and Commands from GetCoreObject but later calls QBCore.Shared.Trim. With the reviewed filtered core object, Shared is absent. Include the shared namespace in a reviewed local fix and test the complete handler; the source pin is not an endorsement of a working trunk integration.

The new server handler calls the global GetClosestVehicle. Verify that this function exists in your selected server artifact or integration before enabling the trunk flow; client native availability alone does not establish server availability. Do not describe the added checks as a completed security fix without testing the handler, invalid plates, missing entities and repeated requests on staging.

Update checklist

On staging, test the independent command, single entry, optional submenu, close/reopen, reconnect and the resolutions your players use. Confirm one selection produces one notification. Test actual job/vehicle/trunk/stretcher integrations separately; this help demo does not validate them.

To roll back, remove the added config entry, close the wheel, stop qbnet-help and remove its startup entry. There are no persistent records to restore. Keep config, NUI assets and client/server integration changes separately identifiable. Return to resource references for related menus.

Found an issue in this guide?

Send the page URL, the affected example, and a source or reproduction to the site maintainer. For a server or resource problem, use the support guide.

On this page

Leonida RP server website built with RPWebsite
RPWebsite

Advertisement · RPWebsite

Want a website for your server?

Launch a site with live player status, rules, and a join button in minutes.

Build your website