DialogWindow - Create dynamic, interactive GUI dialogs entirely from YAML files

DialogWindow

Turn any command into a clean in-game GUI - no code required.

DialogWindow lets server admins build fully custom dialog menus for Minecraft using simple YAML files.

Built on top of Minecraft's native Dialog API available in Minecraft 1.21.6+, DialogWindow turns commands that would normally just print text into chat into clean graphical interfaces with buttons, checkboxes, dropdowns, sliders, text fields, custom item displays, and more.

Perfect for warp menus, rule acceptance screens, shop confirmations, settings panels, rank pickers, PvP toggles, or any admin tool that deserves more than a wall of chat text.


Features

• Define complete GUIs using simple YAML files — no plugin development required
• Add labels, buttons, checkboxes, dropdowns, sliders, and text inputs
• Display custom items with names, lore, skull textures, glow effects, enchantments, and more
• Execute console and player commands based on user selections
• Use PlaceholderAPI placeholders inside titles, labels, items, commands, and inputs
• Organize large amounts of menus using folders and subfolders
• Reload interfaces without restarting your server
• Built for Spigot servers

Examples

Warp Menu



Twitch Settings



Twitch Link



Requirements

• Minecraft 1.21.6 or newer
• Java 17+
• PlaceholderAPI - optional, but recommended

Older Minecraft versions are not supported because DialogWindow relies on Minecraft's built-in Dialog API.

Getting Started

1. Download DialogWindow and place the JAR inside your plugins folder
2. Restart your server
3. DialogWindow automatically generates config.yml, messages.yml, and an interfaces/ folder containing working examples
4. Edit an existing interface or create your own YAML interface
5. Run /dwreload
6. Done - your interface is ready to use

Commands & Permissions

/dwreload
Reloads the configuration, messages, and all interfaces without restarting the server.

Permission:
dialogwindow.reload

/dwreport
Generates a diagnostic report that can be used when requesting support.

Permission:
dialogwindow.report

How an Interface Works

Every YAML file inside the interfaces/ folder defines a command and its corresponding dialog.

Here is a minimal warp menu example:

command:
name: "warpui"
description: "Warp selection menu"
permission: "dialogwindow.warpui"

Elements are rendered from top to bottom exactly as they appear in the YAML file.

You can freely mix labels, items, inputs, and buttons to build the interface you need.

Available Inputs

Text
A free text field where players can enter custom text.

Checkbox
An on/off toggle with configurable return values.

Single Option
A dropdown/select menu that lets the player choose one option.

Number Range
A slider with configurable minimum, maximum, and step values.

Placeholder Support
DialogWindow includes several built-in placeholders:

Full PlaceholderAPI support is also available.

Placeholders can be used inside:

• Dialog titles
• Labels
• Input defaults
• Button commands
• Hover text

If PlaceholderAPI is installed, DialogWindow automatically processes supported placeholders.

Use Cases
DialogWindow can be used for almost any command-based interface, including:

• Warp menus
• Shop confirmations
• Rule acceptance dialogs
• ⚔ PvP toggles
• Rank selection
• ⚙ Settings panels
• Command configuration interfaces
• Administrative tools

Web Editor
Don't want to write YAML manually?

Build your DialogWindow interfaces visually using the web editor:

https://www.morelaid.com/dwe

Support

Need help, found a bug, or have a question?

Join the Discord server:

https://discord.gg/5zuC36R

Before requesting support, please run:

/dwreport

and include the generated report with your request.
This makes troubleshooting much faster.

Questions are welcome in German or English.

Statistics