> 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/conversation.md).

# Conversation

WIKI IN BUILD...

Conversation is a plugin to create complex conversations with NPC  or sign or things.

You can create conversation with a YML file with a simple specific syntax, the plugin is really permissive if you know how to code the API is super cool and let you create every possible thing you can want in a conversation. 

If you want a specific feature to be added you can always ask me to add it on the support discord.

Support Discord: <https://discord.gg/PUnTJHThxJ>

My Spigot: <https://www.spigotmc.org/members/supermax_8.479560/>

**Example of a conversation**

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FihGAjWxUgwiVRNq31bQV%2Fuploads%2FjWgMnJbg4OOkuf2NgRoH%2FLunar%20Client%20(1.19.2-5cbb699_master)%2004-02-2023%2022-54-27.mp4?alt=media&token=a3090010-bae4-4375-9334-7c6502a6b616>" %}

## Example of a basic conversation using npc as trigger

```yaml
Bob:
  triggers:
    npc:
      id: 11
      triggers:
        - leftclick
  options:
    - hideChat
    - moveawaytoend{r=4}
    - shifttoend
    - endstep{s=end}
    - noDamage
  patterns:
    green: "&#30a651"
    name: "&8[&2Bob§8]&7:"
  steps:
    hello:
      type: delayed-text
      delay: 15
      text:
        - "{name}"
        - "&7Hi %player_name%, how are you ?"
      next: d
    whatDoYouWant:
      type: movement-text-choice
      text:
        0:
          - "{name}"
        1:
          - "&7Do you need something ?"
        2:
          - "&8- &7What is the price of your wood ?"
          - "&8- &eWhat is the price of your wood ?"
        3:
          - "&8- &7I'm Stronger than you !"
          - "&8- &eI'm Stronger than you !"
        4:
          - "&8- &7Let's fight ! I'm sure that I'm the best !"
          - "&8- &eLet's fight ! I'm sure that I'm the best !"
      choices: price,nop,combat
    price:
      type: delayed-text
      delay: 15
      text:
        - "{name}"
        - "&6&l10$ &7the plank"
      next: whatDoYouWant
    nop:
      type: delayed-text
      delay: 15
      text:
        1:
          - "{name}"
          - "&7You're obviously not"
        2:
          - "&7But you can buy me &#574733wood &7!"
      next: whatDoYouWant
    combat:
      type: console-command
      command: "kill %player_name%"
      next:
        youCantBeatMe:
          type: delayed-text
          text:
            1:
              - "{name}"
              - "&7You can't beat me I'm the best of the world"
    end:
      type: delayed-text
      text:
        - "{name}"
        - "&7Ciao %player_name% !"
```