# Conversation Properties

## Random Dialogue

If enabled, this conversation will select and send a random dialogue.

```yaml
random_dialogue: true
```

## Interrupt Actions

Here you can set actions to be executed if the player interrupts the conversation in any of the dialogues of the current conversation tree. Ways of interrupting a conversation: Leaving the server, using /int stop command, stopping the server, leaving the conversation radius. All actions [HERE](/interactions/actions.md).

```yaml
interrupt_actions:
- 'console_command: say %player% interrupted a conversation.'
- 'actionbar: &cConversation interrupted...;60'
```

## Dialogue

It refers to the multiple dialogues this conversation can have. Click [HERE](/interactions/dialogues-properties.md) for Dialogue properties.

```yaml
dialogue:
    dialogue1:
    ...
    dialogue2:
    ...
```

## Options

It refers to the multiple options this conversation can have. Click [HERE](/interactions/options-properties.md) for Options properties.

```yaml
options:
    option1:
    ...
    option2:
    ...
```

## Options in Dialogue

When this option is enabled, options will not be sent in the common format but instead you can add them as variables inside the **last dialogue** of this conversation. This allows you to write more dialogue text below the options.

```yaml
options_in_dialogue: true
```

<figure><img src="/files/KX8zGza0IKwnvBFRIbWk" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
**IMPORTANT** when this option is enabled:

* The last dialogue of this conversation must contain the `%option_X%` variable for each option you have defined.
* The last dialogue must also have a time of 0, so the options are sent along the dialogue.
  {% endhint %}

```yaml
# Example
# options_in_dialogue is enabled on conversation1.
# dialogue2 has %option_1% and %option_2% variables on the text.
# The time of dialogue is 0.
conversation:
  conversation1:
    dialogue:
      dialogue1:
        text:
        - '{centered}&8&m000                                                           &8&m000'
        - '{centered}#fffa9c&lHegror'
        - '{centered}#dbdbdbWelcome my friend! Welcome to the island!'
        - ' '
        - '{centered}&8&m000                                                           &8&m000'
        time: 6
        show_name: false
      dialogue2:
        text:
        - '{centered}&8&m000                                                           &8&m000'
        - '{centered}#fffa9c&lHegror'
        - '{centered}#dbdbdbIf I am not wrong, you are &b%player% #dbdbdbright?'
        - ' '
        - '                    %option_1%'
        - '                    %option_2%'
        - '{centered}&8&m000                                                           &8&m000'
        time: 0
        show_name: false
    options:
      option1:
        text: '&7Yes'
        start_conversation: conversation2
      option2:
        text: '&7No'
        start_conversation: conversation3
    options_in_dialogue: true
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ajneb97.gitbook.io/interactions/conversation-properties.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
