VIP - Interactions | Create Complex Conversations with NPCs

Minecraft Versions: 1.8, 1.9, 1.10, 1.11, 1.12, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20

Source: https://www.spigotmc.org/resources/87762/

Documentation: https://ajneb97.gitbook.io/interactions/

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/

Utilities:
- ✓ GUI Inventory to create Conversations
- ✓ Command to start a conversation from any point
- ✓ Command to stop a conversation
- ✓ Command to verify plugin errors
- ✓ Influence points system with conversation entities
- ✓ Prevent command and chat use while in conversation
- ✓ Prevent inventory interact while in conversation
- ✓ Prevent mob damage while in conversation
- ✓ Hide received chat messages while in conversation
- ✓ Command whitelist while in conversation
- ✓ 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

Conversation Entities Properties:
- ✓ Name
- ✓ Starting points (NPCs or entities)
- ✓ Starting/Ending radius for conversations
- ✓ Enable slow (zoom) effect
- ✓ Block player movement
- ✓ Save conversation progress
- ✓ Permission to start conversation
- ✓ Cooldown for conversations
- ✓ Enable hologram dialogues
- ✓ Mutiple conversations

Conversation Properties:
- ✓ Multiple dialogues branches
- ✓ Multiple player options
- ✓ Enable random dialogues
- ✓ Interrupt conversation actions

Dialogues Properties:
- ✓ Configurable text lines
- ✓ Next/Skip dialogue button
- ✓ Center text variable
- ✓ JSON format
- ✓ Dialogue time
- ✓ Send options when dialogue finishes
- ✓ Start another conversation when dialogue finishes
- ✓ Multiple Actions (execute commands, play sound, send title message, give potion effect, and more!)
- ✓ Enable show conversation name
- ✓ Conditional Dialogues (based on PlaceholderAPI variables)

Options Properties:
- ✓ Option text
- ✓ Start conversation on option select
- ✓ Multiple Actions
- ✓ Requirements to show (based on PlaceholderAPI variables)
- ✓ Write option number in chat
- ✓ Clickable options
- ✓ Selectable options (W, S keys and SNEAK/JUMP)

Compatibility:
- ✓ Citizens (To start conversations from NPCs)
- ✓ PlaceholderAPI (For requirements using variables, and variables in dialogues)
- ✓ ProtocolLib (To completely block player movement while in conversation and completely hide chat messages while player is in a conversation)
- ✓ Holographic Displays (To enable hologram dialogues)
- ✓ Decent Holograms (To enable hologram dialogues)
- ✓ CMI (To enable hologram dialogues)
- ✓ 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/)
5. HolographicDisplays (optional, to display hologram dialogues while in conversation, https://dev.bukkit.org/projects/holographic-displays/) or Decent Holograms (https://www.spigotmc.org/resources/96927/) or CMI (https://www.spigotmc.org/resources/3742/)

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/

Videos

Translations

Spanish [Click Here]
Russian [Click Here] - By @Sidka
Russian [Click Here] - By @FillNati
Chinese [Click Here] - By @Bean_Yuan
Portuguese [Click Here] - By @diegoshadow
Vietnamese [Click Here] - By @nhuttiendat

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:

name: '&a&lExample NPC'
starts_with: []
block_movement: true
start_conversation_radius: 0
end_conversation_radius: 5
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:

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

A dialogue refers to a message to be sent in the chat to the player.

Example:

Code:

dialogue:
      dialogue1:
        text:
        - "&7Hello citizen, what can I do for you?"
        time: 4

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:

option1:
        text: "&eTell me about the city."
        start_conversation: conversation2
      option2:
        text: "&eBye"
        start_conversation: conversation3

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:

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>[/B] Deletes an already created conversation.
/interactions verify Checks ALL conversations for errors.
/interactions reload Reloads the plugin configuration files.
/interactions resetplayer <player> <conversation> (optional)<dialogue> Resets a conversation (or dialogue) for a player. The dialogue must be written like this: <conversation>.<dialogue>
/interactions list[/B] 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.
/interactions stop <player> Stops the current conversation of a player.
/interactions influence set/add/remove <player> <conversation_entity> <value> Manages player influence with conversation entities.

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)

- interactions.bypasscooldown.<conversation> (Allow players bypass the cooldown of a conversation)