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

# 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.