# Radial Menu

> A pie menu that appears when you hold a key. Quick access to actions, animations, vehicle controls, job functions.

![Screenshot: the radial menu open with 6-8 wedges visible](../screenshots/10-interface/radial-menu-open.png)
*Screenshot needed: the qbx_radialmenu open in-game, showing the wedge options.*

---

## What is the radial menu?

`qbx_radialmenu` is a context-sensitive pie menu. It shows different options depending on:

- Your current job
- What vehicle you're in (or near)
- What you're holding
- Your gang membership

You **hold a key** to open it, navigate by mouse cursor, click a wedge to select.

---

## Opening the radial

Default keybind varies — usually one of:

- **Z** (default in qbx_radialmenu)
- **F4**
- **Hold middle mouse button** (some configs)

Check your server's keybinds in the Settings menu, or `/keybinds` in chat.

---

## Common radial wedges

### General (always available)

- **Animations / emotes** — wave, sit, dance, surrender hands
- **Stretch / cough / spit** — RP filler animations
- **Drop / pickup** — quick item interaction
- **Help / clear** — utility

### When in a vehicle

- **Engine on/off**
- **Lock/unlock doors**
- **Open trunk**
- **Open hood**
- **Toggle seatbelt** (if installed)
- **Switch seats** (passenger ↔ driver)

### When near a vehicle

- **Inspect / damage report**
- **Hood open**
- **Trunk access**

### Job-specific (police)

- **Cuff / un-cuff suspect**
- **Drag / release**
- **Put in vehicle**
- **Take out of vehicle**
- **Check ID**
- **Search**

### Job-specific (EMS)

- **Revive nearest downed player**
- **Treat wounds**
- **Apply bandage**
- **Stretcher in/out**

### Gang-specific

- **Open tablet** (alternative to /gangtablet)
- **Quick spray** (if you have spray can)

---

## Navigation

Once open:

1. Move your mouse to the wedge you want
2. Wedge highlights when hovered
3. Click to select
4. Menu closes automatically

Some wedges open **sub-menus** (a second layer of wedges). Same navigation applies.

---

## Customization

Per-server config decides:

- Which wedges show
- Which keybind opens the menu
- Wedge colors / icons
- Whether off-duty cops still see cop wedges

Players typically can't customize wedges — only admins.

---

## Tips

- **Practice the muscle memory.** Hold key, swing mouse, click = fast emotes
- **Don't open radial in combat.** It takes attention away from aim
- **Use radial for animations.** Quicker than typing `/e wave`
- **Vehicle controls via radial.** Faster than searching for hood/trunk hotkeys
- **Cop cuff via radial.** One of the fastest cuff actions

---

## Common questions

**Why don't I see job wedges?**
- You're off-duty (clock in)
- You're not whitelisted for that job
- The wedge is admin-disabled

**Can I add my own emote to radial?**
Not directly — admin can config which emotes appear. Ask if there's an emote you want added.

**Does the radial work in vehicles?**
Yes — and it changes content based on vehicle state.

**Why does my radial look different from another player's?**
You may have different job context. Cops see cop wedges; civilians don't.

**Can the radial replace all hotkeys?**
You could, but hotkeys are faster for frequent actions. Radial is good for occasional / contextual things.

---

## Related

- [inventory.md](inventory.md) — alternative item access
- [chat-and-commands.md](chat-and-commands.md) — text commands for same actions