Menu Structure & Examples

The Quasar Radial Menu is based on a tree-style structure, where each menu can contain items and categories, and categories can contain other categories infinitely.

The entire structure is defined in config.lua using plain Lua tables and functions.

---

Basic Structure Overview

Every radial menu follows this base structure:

Config.Menu = {
    title = "Main Menu",
    items = {
        -- Items and categories go here
    }
}

• title: Text displayed at the top of the radial menu

• items: List of menu entries (items or categories)

---

Item Types

There are two possible types:

There are two possible types:

1️⃣ Item (Action)

An item executes an action when clicked.

{
    label = "My Action",
    icon = "User",
    type = "item",
    action = function()
        print("Action executed")
    end
}

Required fields:

• label – Text shown in the menu

• icon – Lucide icon name

• type = "item"

• action – Lua function executed on click

---

2️⃣ Category (Submenu)

A category opens a new submenu and can contain more items or categories.

{
    label = "My Category",
    icon = "Folder",
    type = "category",
    items = {
        -- Sub-items here
    }
}

Required fields:

• label

• icon

• type = "category"

• items – List of nested items or categories

---

Simple Example

Config.Menu = {
    title = "Main Menu",
    items = {
        {
            label = "Say Hello",
            icon = "Smile",
            type = "item",
            action = function()
                print("Hello!")
            end
        },
        {
            label = "Utilities",
            icon = "Settings",
            type = "category",
            items = {
                {
                    label = "Open Phone",
                    icon = "Phone",
                    type = "item",
                    action = function()
                        TriggerEvent('qs-smartphone:open')
                    end
                }
            }
        }
    }
}

---

Infinite Nested Categories

There is no depth limit. Categories can be nested as deeply as needed.

{
    label = "Main",
    icon = "Home",
    type = "category",
    items = {
        {
            label = "Vehicles",
            icon = "Car",
            type = "category",
            items = {
                {
                    label = "Doors",
                    icon = "DoorOpen",
                    type = "category",
                    items = {
                        {
                            label = "Lock / Unlock",
                            icon = "Lock",
                            type = "item",
                            action = function()
                                TriggerEvent('vehicle:toggleLock')
                            end
                        }
                    }
                }
            }
        }
    }
}

---

Job Restricted Items

Items and categories can be restricted by job.

{
    label = "Police Actions",
    icon = "Shield",
    type = "item",
    job = "police",
    jobGrade = 2,
    action = function()
        print("Police action")
    end
}

• jobGrade is optional

• Uses minimum grade logic (>=)

---

Multiple Job Support

You can allow multiple jobs with different grades:

job = {
    police = { grade = 1 },
    ambulance = { grade = 2 }
}

The item will appear if any job condition is met (OR logic).

---

Gang Restricted Items

{
    label = "Gang Action",
    icon = "Users",
    type = "item",
    gang = "ballas",
    gangGrade = 1,
    action = function()
        print("Gang action")
    end
}

---

CanInteract examples

The canInteract function lets you control the visibility of items or categories using real-time conditions. It must return true to show the item, or false to hide it.

Use it when visibility depends on player state, position, or context.

---

Examples

-- Only visible when the player is in a vehicle
caninteract = function()
    return IsPedInAnyVehicle(PlayerPedId(), false)
end

-- Only visible when close to a specific location
caninteract = function()
    local coords = GetEntityCoords(PlayerPedId())
    return #(coords - vector3(100.0, 200.0, 30.0)) < 5.0
end

-- Only visible if the player has an item
caninteract = function()
    return exports['qb-core']:HasItem('radio')
end

-- Multiple conditions combined
caninteract = function()
    local ped = PlayerPedId()
    local vehicle = GetVehiclePedIsIn(ped, false)
    return IsPedInAnyVehicle(ped, false) and GetPedInVehicleSeat(vehicle, -1) == ped
end

---

Dynamic Visibility with canInteract

The canInteract function allows real-time checks.

{
    label = "Vehicle Menu",
    icon = "Car",
    type = "item",
    canInteract = function()
        return IsPedInAnyVehicle(PlayerPedId(), false)
    end,
    action = function()
        print("In vehicle")
    end
}

If canInteract returns false, the item or category is hidden.

---

Category Auto-Hiding

Categories are automatically hidden if:

• All child items are filtered by job, gang, or canInteract

• The category becomes empty after filtering

No extra configuration is needed.