{"id":6230,"date":"2026-05-31T17:10:06","date_gmt":"2026-05-31T14:10:06","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/"},"modified":"2026-05-31T17:10:06","modified_gmt":"2026-05-31T14:10:06","slug":"adialogapi","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/","title":{"rendered":"ADialogAPI"},"content":{"rendered":"<p># ADialogAPI<\/p>\n<p>![Modrinth Downloads](https:\/\/img.shields.io\/modrinth\/dt\/adialogapi?style=for-the-badge&#038;logo=modrinth&#038;color=blue)<br \/>\n![License](https:\/\/img.shields.io\/github\/license\/isArkaDarkTime\/ADialogAPI?style=for-the-badge&#038;color=blue)<br \/>\n![Java Version](https:\/\/img.shields.io\/badge\/Java-17%2B-orange?style=for-the-badge&#038;)<br \/>\n![Platform](https:\/\/img.shields.io\/badge\/Platform-Paper%20-green?style=for-the-badge&#038;)<\/p>\n<p>**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.<\/p>\n<p>&#8212;<\/p>\n<p>## \u2728 Features<\/p>\n<p>* **MiniMessage Integration:** Full support for modern formatting (RGB, gradients, hover\/click events).<br \/>\n* **Action System:** Trigger commands, sounds, titles, potion effects, and inventory changes directly from dialog buttons.<br \/>\n* **Dynamic Inputs:** Capture player input through the dialog interface and use it in commands or messages.<br \/>\n* **Cooldown Support:** Prevent dialog spam with per-player cooldowns defined in config.<br \/>\n* **Developer API:** Custom events for opening, clicking, and closing dialogs to build complex logic.<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83d\ude80 Quick Start (For Admins)<\/p>\n<p>### 1. Installation<br \/>\n1. Download the latest `.jar` from Modrinth.<br \/>\n2. Place it in your server&#8217;s `plugins` folder.<br \/>\n3. Restart the server.<\/p>\n<p>### 2. Configuration Example<br \/>\nDialogs are stored in the `dialogs\/` folder.<\/p>\n<details>\n<summary>Basic example of dialog yaml<\/summary>\n<p>  &#8220;`yaml<br \/>\n# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500<br \/>\n# Dialog: notice example<br \/>\n# A simple informational window with a single OK button.<br \/>\n# Recommended for announcements, tips, or welcome messages.<br \/>\n# \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500<\/p>\n<p># Displayed at the top of the dialog window.<br \/>\ntitle: &#8220;<gold><bold>\u2726 Welcome to the Server!&#8221;<\/p>\n<p># true  &#8211; Player can press ESC to close the dialog.<br \/>\n# false &#8211; Player must click the OK button to close.<br \/>\ncan_close_with_escape: false<\/p>\n<p># Cooldown in seconds before the same player can open this dialog again.<br \/>\n# 0 = no cooldown (default).<br \/>\ncooldown: 0<\/p>\n<p># Dialog type:<br \/>\n# &#8211; notice: single OK button<br \/>\n# &#8211; confirmation: Yes \/ No buttons<br \/>\ntype: notice<\/p>\n<p># Optional: register a command that opens this dialog.<br \/>\n# Leave empty (&#8220;&#8221;) to skip.<br \/>\nopen_command: &#8220;welcome&#8221;<\/p>\n<p># Optional: permission required to use open_command.<br \/>\n# Leave empty (&#8220;&#8221;) to allow all players.<br \/>\nopen_permission: &#8220;&#8221;<\/p>\n<p>body:<br \/>\n  # Simple text line in the dialog.<br \/>\n  &#8211; type: text<br \/>\n    content: &#8220;<gray>Hello, traveler! We&#8217;re glad to see you here.&#8221;<\/p>\n<p>  # Empty text used as spacer.<br \/>\n  &#8211; type: text<br \/>\n    content: &#8220;&#8221;<\/p>\n<p>  &#8211; type: text<br \/>\n    content: &#8220;<yellow>Explore, build, and have fun!&#8221;<br \/>\n&#8220;`<br \/>\n<\/details>\n<p>&#8212;<\/p>\n<p>## \ud83d\udee0 Developer API (In Future)<\/p>\n<p>### Events<\/p>\n<p>Listen to custom events to integrate ADialogAPI with your systems:<\/p>\n<p>&#8211; `DialogOpenEvent`: Fired when a dialog is about to open (Cancellable).<br \/>\n&#8211; `DialogButtonClickEvent`: Captures button clicks and any associated user inputs.<br \/>\n&#8211; `DialogCloseEvent`: Fired when a dialog is closed (supports reasons like ESCAPE or PLUGIN).<\/p>\n<p>### Accessing the Manager<\/p>\n<p>You can open dialogs via the `DialogManager`:<\/p>\n<p>&#8220;`java<br \/>\nADialogAPI.getApi().showDialog(player, &#8220;dialog_id&#8221;);<br \/>\n&#8220;`<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83d\udcdc Commands &#038; Permissions<\/p>\n<p>The main command is `\/adialogapi` (aliases: `\/adapi`).<\/p>\n<p>| Command | Description | Permission |<br \/>\n| &#8212; | &#8212; | &#8212; |<br \/>\n| `\/adialogapi help` | View all available commands | `adialogapi.command.help`<br \/>\n| `\/adialogapi show <id> [player]` | Open a dialog for yourself or others | `adialogapi.command.show`<br \/>\n| `\/adialogapi list` | List all loaded dialogs | `adialogapi.command.list`<br \/>\n| `\/adialogapi reload [id]` | Reload all or a specific dialog | `adialogapi.command.reload`<br \/>\n| `\/adialogapi create <id>` | Create a new dialog template | `adialogapi.command.create`<br \/>\n| `\/adialogapi delete <id>` | Remove an existing dialog | `adialogapi.command.delete`<br \/>\n| `\/adialogapi info <id>` | View detailed info about a dialog | `adialogapi.command.info` <\/p>\n<p>&#8212;<\/p>\n<p>## \ud83e\udd1d Support<\/p>\n<p>&#8211; **Issues:** Report bugs or request features via GitHub Issues.<br \/>\n&#8211; **Discussions:** Ask questions and share your configs in the Discussions tab.<br \/>\n&#8211; **Discord server:** My official discord server for support, bug-reports and fun &#8211; ArkaDarkTime Hub<\/p>\n<p>&#8212;<\/p>\n<p>## \u2696\ufe0f License<\/p>\n<p>Distributed under the **GNU GPL v3 License**. See LICENSE for details.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A flexible dialog API for Minecraft plugins with configurable buttons and actions.<\/p>\n","protected":false},"featured_media":6231,"template":"","meta":{"_minecraft_slug":"adialogapi","_minecraft_project_id":"ktZRZUVi","_minecraft_author":"arkadarktime","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":20,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"adialogapi.zip","_minecraft_size_bytes":275603,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T22:31:53.790494Z","_minecraft_date_created":"2026-03-03T03:19:19.795104Z","_minecraft_date_modified":"2026-03-06T21:01:45.341239Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/adialogapi","_minecraft_icon_attachment_id":6231,"_minecraft_imported_at":"2026-05-31T14:10:07+00:00","_minecraft_import_hash":"fa3e1ad69b6b9b5856797e4d1b8b66f7","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,127,128,867,92],"mod_loader":[132,133],"minecraft_version":[40,41,79,80,81,82],"class_list":["post-6230","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>ADialogAPI - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"ADialogAPI - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A flexible dialog API for Minecraft plugins with configurable buttons and actions.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/adialogapi\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/adialogapi\\\/\",\"name\":\"ADialogAPI - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/adialogapi\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/adialogapi\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/adialogapi-icon-8f0e2d76a977751b377bd1d944ce4ba2295b6617_96.webp\",\"datePublished\":\"2026-05-31T14:10:06+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/adialogapi\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/adialogapi\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/adialogapi\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/adialogapi-icon-8f0e2d76a977751b377bd1d944ce4ba2295b6617_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/05\\\/adialogapi-icon-8f0e2d76a977751b377bd1d944ce4ba2295b6617_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/adialogapi\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"ADialogAPI\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"ADialogAPI - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/","og_locale":"en_US","og_type":"article","og_title":"ADialogAPI - Minecraft","og_description":"A flexible dialog API for Minecraft plugins with configurable buttons and actions.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/","name":"ADialogAPI - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/05\/adialogapi-icon-8f0e2d76a977751b377bd1d944ce4ba2295b6617_96.webp","datePublished":"2026-05-31T14:10:06+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/05\/adialogapi-icon-8f0e2d76a977751b377bd1d944ce4ba2295b6617_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/05\/adialogapi-icon-8f0e2d76a977751b377bd1d944ce4ba2295b6617_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/adialogapi\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"ADialogAPI"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/6230","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/6231"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=6230"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=6230"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=6230"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=6230"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}