# How to Start

## Requirements

**1) Spigot/Paper**

{% hint style="warning" %}
You need Spigot or Paper for the plugin to work. Don't use Craftbukkit.
{% endhint %}

**2) NPC Plugin**

{% hint style="info" %}
If you want to create conversations with NPCs you need one of the following plugins:

**Citizens:** [www.spigotmc.org/resources/citizens.13811/](https://www.spigotmc.org/resources/citizens.13811/)\
**FancyNpcs:** <https://modrinth.com/plugin/fancynpcs>

If you don't use one of these plugins you can still create conversations with other named entities.\
You can also use the `/interactions start` command to start conversations in certain locations even from other plugins (including other NPC plugins).
{% endhint %}

**3) PlaceholderAPI**

{% hint style="info" %}
This dependency is completely optional.\
If you want to create conditional dialogues or options with requirements you will need to install PlaceholderAPI on your server to get a lot of variables.\
<https://www.spigotmc.org/resources/placeholderapi.6245/>\
The plugin also has support for PlaceholderAPI variables in dialogue messages!
{% endhint %}

{% hint style="warning" %}
Remember to follow the instructions for downloading variables. If you need to use variables from the **Player** expansion you need to use the following commands to get them to work:

1\) /papi ecloud download Player\
2\) /papi reload
{% endhint %}

**4) ProtocolLib**

{% hint style="info" %}
This dependency is completely optional.\
You can use it to set the `block_movement_mode` option to `PROTOCOLLIB` in the config to completely block player movement while in conversation.\
<https://www.spigotmc.org/resources/protocollib.1997/>
{% endhint %}

**5) Hologram Plugin**

{% hint style="info" %}
These dependencies are completely optional.\
You can use them to enable the `hologram_dialogues` option in [Conversation Entities](/interactions/conversation-entities-properties.md).

**Holographic Displays:**[ https://dev.bukkit.org/projects/holographic-displays](https://dev.bukkit.org/projects/holographic-displays)\
**Decent Holograms:** <https://www.spigotmc.org/resources/96927/>\
**FancyHolograms:** [modrinth.com/plugin/fancyholograms](https://modrinth.com/plugin/fancyholograms)
{% endhint %}

## Installation

To install the plugin on your server just place the Interactions file inside your plugins folder and start your server. Examples files will be generated in the **conversations** folder, you can use them as a reference or delete them.


---

# 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/how-to-start.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.