> ## 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.

# Option Dialogue

> Floating choice menu.

The `textdisplay_option` entry presents the player with a list of choices rendered as floating text in the world. Players select options by looking/sneaking or clicking.

## Configuration

<ResponseField name="text" type="String">
  The question or prompt text.
</ResponseField>

<ResponseField name="options" type="List<Option>">
  List of available choices.
</ResponseField>

<ResponseField name="timer" type="Duration" default="0s">
  Auto-cancel timer (0s = infinite).
</ResponseField>

<ResponseField name="cancelTriggers" type="List<Ref<TriggerableEntry>>">
  Triggers to fire if the timer expires.
</ResponseField>

## Styling

<ResponseField name="scale" type="Double" default="1.0">
  Size multiplier for the text.
</ResponseField>

<ResponseField name="billboard" type="Boolean" default="true">
  If true, text always rotates to face the player.
</ResponseField>

<ResponseField name="selectedOptionBackgroundColor" type="Color" default="Gold">
  Background color for the currently highlighted/hovered option.
</ResponseField>

<ResponseField name="unselectedOptionBackgroundColor" type="Color" default="Dark Grey">
  Background color for other options.
</ResponseField>

## Option Definition

<ResponseField name="text" type="String" required>
  The text of the choice.
</ResponseField>

<ResponseField name="triggers" type="List<Ref<TriggerableEntry>>">
  Triggers to fire when this option is selected.
</ResponseField>

<ResponseField name="criteria" type="List<Criteria>">
  Conditions for this option to be visible.
</ResponseField>

<CodeGroup>
  ```yaml Example theme={null}
  dialogue:
    type: textdisplay_option
    text: "Where to next?"
    options:
      - text: "To the Castle"
        triggers: ["warp_castle"]
      - text: "Stay here"
        triggers: ["end_dialogue"]
  ```
</CodeGroup>