# 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% !"
```


---

# 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://supermax-8.gitbook.io/conversation/conversation.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.