Plugin that grants you ability to create complex dialogs (chains of elements) and display them to your players.

Requirements

Requires Java 21 (or higher) and Paper 1.20.1 #161 (or higher).

Features

Dialogs allows you to do the following:

• Create animated NPC-like dialogs.
• Create complex chains of delayed actions.
• Choose from wide selection of available actions and customize them as you like.
  • chat_message - Sends a chat message to specified audience.
  • actionbar_animation - Sends a typing animation of specified text to the target.
  • console_command - Makes console execute a command.
  • player_command - Makes target player execute a command.
  • pause - Waits for desired amount of ticks, before proceeding to the next action.
  • ...more to come in the future!
• Test placeholder-based conditions before executing an action.
  • equals and not_equals - Checks if two strings are equal.
  • contains and not_contains - Checks if one string contains another.
  • starts_with and ends_with - Checks if one string starts or ends with another.
  • greater_than, greater_than_or_equals - Checks if one number is greater than another.
  • smaller_than and smaller_than_or_equals - Checks if one number is smaller than another.

Every element type except for actionbar_animation have built-in support for PlaceholderAPI.

More detailed guide can be found in the plugins/Dialogs/dialogs/default.json file that is created the first time you start the plugin.

Recommended to be used along with FancyNPCs, LuaLink, Skript, WorldGuardExtraFlags or other plugins that allow for execution of console commands upon certain action.

Default Configuration Showcase

2023-08-26_11-53-42.1.mp4

Building

Some dependencies use GitHub Gradle Registry and thus may require extra configuration steps for the project to build properly.

# Cloning repository.
$ git clone https://github.com/Grabsky/Dialogs.git
# Entering cloned repository.
$ cd Dialogs
# Compiling and building artifacts.
$ gradlew clean build

Contributing

This project is open for contributions. Help in regards of improving performance, adding new features or fixing bugs is greatly appreciated.