> For the complete documentation index, see [llms.txt](https://supermax-8.gitbook.io/conversation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://supermax-8.gitbook.io/conversation/basics/file.md).

# File

In one file you can put multiple conversations

```yaml
Jim:
#....conversation content
JimBrother:
#....conversation content
JimHouseSign:
#....conversation content
```

A conversation is separated in several parts

#### [Steps](/conversation/steps/consolecommandstep.md)

Step represent an action in the conversation, the step can lead to another step or to several other steps and thus create branches.

With this you can for exemple, display text, execute a command, display clickable text               etc...

Exemple:

```yaml
    hello:
      type: delayed-text
      delay: 10
      text:
        - "{name}"
        - "§7Bonjour %player_name%, comment vas tu ?"
      next: d
```

#### [Conditions](/conversation/conditions/papicondition.md)

The conditions are as the name indicates conditions necessary to either execute a step or an entire conversation

\
Exemple:

```yaml
  conditions:
    papi:
      - "%player_health% > 10"
```

#### [Triggers](/conversation/triggers/blocktrigger.md)

Triggers allow you to trigger a conversation based on something, for example clicking on an npc or a block or passing by an npc or a block

Exemple:

```yaml
  triggers:
    npc:
      id: 7
      triggers:
        - rightclick
        - around{r=2}
```

#### [Options](/conversation/options/cancelcommandoption.md)

The options allow you to have an effect during the entire conversation. For example stop the player's movement, stop the conversation when the player moves away from the place of the conversation or make the player immortal during the conversation.

Exemple:

```yaml
  options:
    - moveawaytoend{r=4}
    - shifttoend
    - endstep{s=end}
    - hideChat
```