Skip to main content
Bridge.Radial opens a circular action wheel — a ring of icon options the player clicks. Use it for a compact set of contextual actions (hands up, point, surrender) bound to a key. Options can open submenus to nest deeper sets. The wheel does not block — your onSelect callbacks fire as the player picks options, and you close it with Bridge.Radial.Close().

Availability

Client only. Radial is always rendered on the bridge’s own NUI — it is not provider-resolved, so atlas:ui does not change it.
Bridge.Radial.Open(def)
Bridge.Radial.Close()

Signature

Bridge.Radial.Open

Bridge.Radial.Open(def)
title
string
Shown in the center hub when nothing is hovered.
options
table[]
required
The wheel segments. Each option is shaped below.
onClose
function
Called when the wheel closes (after a leaf select, or on dismiss with ESC). Not called when an option opens a submenu.

Option fields

options[].label
string
required
The segment label, shown under its icon and in the hub on hover.
options[].icon
string
An icon name, or an image URL (http…, nui://…, data:…, or a path ending in .png/.jpg/.webp/.gif/.svg).
options[].disabled
boolean
Greys the segment out and blocks selection.
options[].menu
boolean
Marks this option as opening a submenu — selecting it keeps the wheel focused so you can open the next radial in onSelect, and onClose is not fired.

Bridge.Radial.Close

Takes no arguments. Closes the wheel and releases focus.

Examples

Bridge.Radial.Open({
    title = 'Quick actions',
    options = {
        { label = 'Hands up', icon = 'hands',  onSelect = function() handsUp() end },
        { label = 'Surrender', icon = 'flag',  onSelect = function() surrender() end },
    },
})
An option with menu = true keeps the wheel focused on select — open the next Bridge.Radial.Open from its onSelect. A normal (leaf) option closes the wheel and fires onClose.
The hovered segment, the ring, and the hub all tint to the player’s theme accent automatically. Because Radial is bridge-NUI only, atlas:ui "ox" does not affect it.