> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# BetterHUD Cursor Menu

> Interactive HUD menu controlled by player gaze direction.

The `betterhud_cursor_menu` allows you to create mouse-like navigation within Minecraft using a BetterHUD popup.

## Configuration

```yaml theme={null}
id: "interaction_menu"
popupId: "menu_popup"
yawRange: 60.0 # Full width of movement
pitchRange: 40.0 # Full height of movement
buttons:
  - id: "shop"
    x_percent: 25
    y_percent: 50
    width_percent: 10
    height_percent: 10
    onClick:
      - !ref "shop_trigger"
```

### Variables sent to BetterHUD

The following variables are updated in real-time while the menu is open:

| Variable              | Description                                          |
| :-------------------- | :--------------------------------------------------- |
| `cursor_x`            | X position (0-100%)                                  |
| `cursor_y`            | Y position (0-100%)                                  |
| `hovered_button`      | ID of the button being hovered                       |
| `button_<id>_hovered` | `1` if the specific button is hovered, `0` otherwise |

> \[!TIP]
> Use `{button_shop_hovered}` in your BetterHUD layout to change the texture or scale of a button when the player looks at it.