✓ Interactions | Create Complex Conversations with NPCs [1.8-1.17] 1.21.5

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13
• 1.14
• 1.15
• 1.16
• 1.17

Donation Link:https://paypal.me/ajneb97

WHAT CAN I DO WITH INTERACTIONS?
This plugin allows you to add dialogues to your NPCs, creating complex conversation trees. You can add different options to these conversations, so the player can continue talking to the NPC writing (or clicking) the number of the option in the chat.

What makes Interactions better than any other "conversation/dialogue/quests" plugin is that you have total control of the conversations you create. You can add requirements for an option to be selected, or even create "conditional dialogues" that will only be sent to the player if some conditions are met. You can also execute different actions to the player within a conversation, like giving him a potion effect or executing a command.

You can create and edit conversations ingame using the plugin GUI!




You can use this plugin as a support for many Quest plugins that don't have an extensive dialogue system!



FULL WIKI ON THIS LINK!
https://ajneb97.gitbook.io/interactions/



- ✓ GUI Inventory to create Conversations
- ✓ Starting NPC or Entity for conversations
- ✓ Starting/Ending radius for conversations
- ✓ Start conversation from any point/location you want (with command)
- ✓ Block player movement while in conversation (with ProtocolLib support)
- ✓ Permission to start a conversation
- ✓ Cooldown for conversations
- ✓ Mutiple conversations/dialogues branches
- ✓ Requirements/conditions for dialogues and options
- ✓ Conditional Dialogues
- ✓ Multiple Actions (execute commands, play sound, send title message, give potion effect, and more!)
- ✓ PlaceholderAPI Requirements using variables
- ✓ PlaceholderAPI variables in dialogues
- ✓ Clickable options
- ✓ Selectable options (W, S keys and SNEAK/JUMP)
- ✓ Next/Skip dialogue button
- ✓ Random dialogues
- ✓ BossBar feature while in conversation (1.9+)
- ✓ ActionBar feature while in conversation
- ✓ Variable to know if a player has reached to some dialogue
- ✓ 1.16 HEX Colors support for chat messages
- ✓ Works with 1.8+


REQUIREMENTS:
1. Spigot or Paper (not craftbukkit)
2. Citizens (optional, to start conversations with NPCs) (https://www.spigotmc.org/resources/citizens.13811/)
3. PlaceholderAPI (optional, to manage requirements, https://www.spigotmc.org/resources/placeholderapi.6245/)
4. ProtocolLib (optional, to completely block player movement while in conversation, https://www.spigotmc.org/resources/protocollib.1997/)

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.

Use /interactions create <conversation> and /interactions edit <conversation> to start creating your first conversation!


You can create and edit a conversation using the GUI inside the game, or maybe you will find more easily to edit everything on the configuration file of each conversation.


To a proper understanding of the plugin check the wiki below. Here you will find the whole plugin explained in detail.

FULL WIKI ON THIS LINK!
https://ajneb97.gitbook.io/interactions/

You can find a FULL EXAMPLE using the plugin Quests here:
https://ajneb97.gitbook.io/interactions/full-examples/quest-example
Videos
English by @SoulStriker_


Spanish by me


Translations
Spanish [Click Here]
Russian [Click Here] - By @Sidka
Russian [Click Here] - By @FillNati
Chinese [Click Here] - By @Bean_Yuan



Spoiler: Conversation Entity
A conversation entity refers to the whole conversation tree for a certain NPC or entity. There is one file per conversation entity which can be found on the /Interactions/conversations folder.

An example of a conversation entity could be a NPC called "Guard" with the file guard.yml

Example:
Code (Text):
name: '&a&lExample NPC'
starts_with: []
block_movement: true
start_conversation_radius: 0
end_conversation_radius: 5
conversation:
Spoiler: Conversation
A conversation refers to a group of dialogues which follows an order. A conversation entity could have multiple conversations and all of them should end by showing the player some options, redirecting to other conversation, or ending the whole conversation.

A conversation must have dialogues and can have multiple options.

Example:
Code (Text):
conversation:
conversation1:
dialogue:
dialogue1:
text:
- "&7Hello citizen, what can I do for you?"
time: 4
options:
option1:
text: "&eTell me about the city."
start_conversation: conversation2
option2:
text: "&eBye"
start_conversation: conversation3
Spoiler: Dialogue
A dialogue refers to a message to be sent in the chat to the player.

Example:
Code (Text):
dialogue:
dialogue1:
text:
- "&7Hello citizen, what can I do for you?"
time: 4
Spoiler: Option
An option is a player selection which will redirect to another conversation. Basically is the "interaction" in chat of the player with the NPC.

Example:
Code (Text):
option1:
text: "&eTell me about the city."
start_conversation: conversation2
option2:
text: "&eBye"
start_conversation: conversation3
Spoiler: Conditional Dialogue
A conditional dialogue is a REPLACEMENT for the dialogue and will be sent to the player ONLY if some requirements are met. For example, we have this dialogue: "Hello adventurer, I hope you are having a great day".

We can add a conditional dialogue that will replace this dialogue ONLY if the player is lower than level 10.

Example:
Code (Text):
dialogue1:
text:
- '&7Hello adventurer, I hope you are having a great day'
time: 2
conditional_dialogue:
conditional_dialogue1:
requires:
- '%player_level% < 10'
start_conversation: conversation2
More information here: Dialogues Properties - Interactions (gitbook.io)



Alias: /int

/interactions help <page> Shows all commands.
/interactions create <conversation> Creates a new conversation for an entity.
/interactions edit <conversation> Edits an already created conversation.
/interactions delete <conversation> Deletes an already created conversation.
/interactions verify Checks ALL conversations for errors.
/interactions reload Reloads the plugin configuration files.
/interactions resetplayer <player> <conversation entity> (optional)<dialogue> Resets a conversation (or dialogue) for a player. The dialogue must be written like this: <conversation>.<dialogue>
/interactions list Shows all created conversation files.
/interactions start <conversation> <player> <x> <y> <z> <world> With this command you can start a conversation for a player. The location is optional and it works for using the leave radius option.

Permissions:
- interactions.admin (To access commands)
- interactions.start.<conversation> (Permission to talk to an NPC If requires_permission option is enabled on the conversation file)




Spoiler: Screenshots


Spoiler: Gifs




Please avoid posting bad ratings before asking. If you have problems or bugs with the plugin contact with me or post on the plugin discussion and I will take a look at it.

Terms & Conditions
By purchasing Interactions you agree to the following Terms & Conditions:
1) You can't resell/-Redacted- this plugin.
2) There are no refunds.
3) You can't decompile this plugin.
4) You can't claim this plugin as your own.
5) Only use this plugin on your server/network.
6) I can change the price of this plugin anytime.