ADialogAPI -----
A flexible dialog API for Minecraft plugins with configurable buttons and actions.ADialogAPI
![[IMG]](//proxy.spigotmc.org/75fb4a5f22cbbb0c32845893b764b7813b8e0a35/68747470733a2f2f696d672e736869656c64732e696f2f6d6f6472696e74682f64742f616469616c6f676170693f7374796c653d666f722d7468652d6261646765266c6f676f3d6d6f6472696e746826636f6c6f723d626c7565)
![[IMG]](//proxy.spigotmc.org/83da65438dfeb576311ab2a0c35ca5f5a0694408/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f697341726b614461726b54696d652f414469616c6f674150493f7374796c653d666f722d7468652d626164676526636f6c6f723d626c7565)
![[IMG]](//proxy.spigotmc.org/dd07844b922b1944e6468da02138f1fbec1848a0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4a6176612d31372532422d6f72616e67653f7374796c653d666f722d7468652d6261646765)
![[IMG]](//proxy.spigotmc.org/72ef447c50130d7f86235d929eccfa536c130ed7/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f506c6174666f726d2d50617065722532302d677265656e3f7374796c653d666f722d7468652d6261646765)
ADialogAPI is a modern, high-performance interactive dialog system for Minecraft servers. It allows you to create immersive RPG-like conversations, complex menus, and user-input forms using simple YAML or a powerful Java API.
✨ Features
1. Installation
Dialogs are stored in the dialogs/ folder.
Developer API (In Future)
Events
Listen to custom events to integrate ADialogAPI with your systems:
- DialogOpenEvent: Fired when a dialog is about to open (Cancellable).
- DialogButtonClickEvent: Captures button clicks and any associated user inputs.
- DialogCloseEvent: Fired when a dialog is closed (supports reasons like ESCAPE or PLUGIN).
Accessing the Manager
You can open dialogs via the DialogManager:
Commands & Permissions
The main command is /adialogapi (aliases: /adapi).
Support
- Issues: Report bugs or request features via GitHub Issues.
- Discussions: Ask questions and share your configs in the Discussions tab.
- Discord server: My official discord server for support, bug-reports and fun - ArkaDarkTime Hub.
⚖️ License
Distributed under the GNU GPL v3 License. See LICENSE for details.
ADialogAPI is a modern, high-performance interactive dialog system for Minecraft servers. It allows you to create immersive RPG-like conversations, complex menus, and user-input forms using simple YAML or a powerful Java API.
✨ Features
- MiniMessage Integration: Full support for modern formatting (RGB, gradients, hover/click events).
- Action System: Trigger commands, sounds, titles, potion effects, and inventory changes directly from dialog buttons.
- Dynamic Inputs: Capture player input through the dialog interface and use it in commands or messages.
- Cooldown Support: Prevent dialog spam with per-player cooldowns defined in config.
- Developer API: Custom events for opening, clicking, and closing dialogs to build complex logic.
1. Installation
- Download the latest .jar from Modrinth.
- Place it in your server's plugins folder.
- Restart the server.
Dialogs are stored in the dialogs/ folder.
Code (YAML):
# ─────────────────────────────────────────────
# Dialog: notice example
# A simple informational window with a single OK button.
# Recommended for announcements, tips, or welcome messages.
# ─────────────────────────────────────────────
# Displayed at the top of the dialog window.
title : "<gold><bold>✦ Welcome to the Server!"
# true - Player can press ESC to close the dialog.
# false - Player must click the OK button to close.
can_close_with_escape : false
# Cooldown in seconds before the same player can open this dialog again.
# 0 = no cooldown (default).
cooldown : 0
# Dialog type:
# - notice: single OK button
# - confirmation: Yes / No buttons
type : notice
# Optional: register a command that opens this dialog.
# Leave empty ("") to skip.
open_command : "welcome"
# Optional: permission required to use open_command.
# Leave empty ("") to allow all players.
open_permission : ""
body :
# Simple text line in the dialog.
- type : text
content : "<gray>Hello, traveler! We're glad to see you here."
# Empty text used as spacer.
- type : text
content : ""
- type : text
content : "<yellow>Explore, build, and have fun!"
# Dialog: notice example
# A simple informational window with a single OK button.
# Recommended for announcements, tips, or welcome messages.
# ─────────────────────────────────────────────
# Displayed at the top of the dialog window.
title : "<gold><bold>✦ Welcome to the Server!"
# true - Player can press ESC to close the dialog.
# false - Player must click the OK button to close.
can_close_with_escape : false
# Cooldown in seconds before the same player can open this dialog again.
# 0 = no cooldown (default).
cooldown : 0
# Dialog type:
# - notice: single OK button
# - confirmation: Yes / No buttons
type : notice
# Optional: register a command that opens this dialog.
# Leave empty ("") to skip.
open_command : "welcome"
# Optional: permission required to use open_command.
# Leave empty ("") to allow all players.
open_permission : ""
body :
# Simple text line in the dialog.
- type : text
content : "<gray>Hello, traveler! We're glad to see you here."
# Empty text used as spacer.
- type : text
content : ""
- type : text
content : "<yellow>Explore, build, and have fun!"
Developer API (In Future)
Events
Listen to custom events to integrate ADialogAPI with your systems:
- DialogOpenEvent: Fired when a dialog is about to open (Cancellable).
- DialogButtonClickEvent: Captures button clicks and any associated user inputs.
- DialogCloseEvent: Fired when a dialog is closed (supports reasons like ESCAPE or PLUGIN).
Accessing the Manager
You can open dialogs via the DialogManager:
Code (Java):
ADialogAPI.
getApi
(
).
showDialog
(player,
"dialog_id"
)
;
The main command is /adialogapi (aliases: /adapi).
Support
- Issues: Report bugs or request features via GitHub Issues.
- Discussions: Ask questions and share your configs in the Discussions tab.
- Discord server: My official discord server for support, bug-reports and fun - ArkaDarkTime Hub.
⚖️ License
Distributed under the GNU GPL v3 License. See LICENSE for details.
Resource Information
Author:
----------
Total Downloads: 13
First Release: Mar 6, 2026
Last Update: Mar 6, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings