Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
UltraDialogue
Real dialogue screens for your NPCs: a portrait, what the character says, and the player's answers as buttons. Every answer can branch the conversation, open a menu, run commands or hand over items.
It uses the native dialog screens Minecraft added in 1.21.6, so no client mod is needed.

Conversations in YAML
One file per character in dialogues/. Nodes, answers, and where each answer leads:
name: '&2&lThe Wandering Merchant'
npcs: [merchant] # FancyNpcs NPC names
portrait: 'npc | item:EMERALD' # the NPC skin, or an emerald if it has none
start:
- if: '!flag:met_merchant' # first time...
node: intro
- node: hello # ...and every time after
nodes:
intro:
on-show: ['flag: met_merchant']
text: 'Psst! You, the one with empty pockets. Come closer.'
next: hello
hello:
text: 'My stock changes every &fMonday&f.'
answers:
- text: '&2Show me your goods'
actions: ['menu: shop']
- text: '&7Where do you get all this?'
goto: secret
- text: '&8Not interested'
goto: end
What it can do
- Actions on any answer: go to another node or dialogue, open a menu, run a player or console command, send a message, title or action bar, play a sound.
- Conditions that hide or lock answers: permissions, player flags, affinity, BeautyQuests
quests and any PlaceholderAPI placeholder (
%vault_eco_balance% >= 1000). - Locked answers show greyed out with a hint, a Back button remembers the way, and Exit stays pinned to the bottom.
- Affinity: a hidden friendship level per player and per character. Kind answers raise it, rude ones lower it, and new greetings and secrets unlock as it grows.
- Conversations that don't repeat: several variants per line and questions that rotate.
- Deliveries: check, take and give items (vanilla, UltraBoss trophies, UltraRevive totems or any item by its hidden tag, model or name). Taking is all or nothing and checked again on click.
- Player flags to remember what someone already did, stored on the player (no database).
- Portraits: the NPC's skin, any player's skin, a texture or any item.
Free rows and RPG buttons
layout: [1, 2, 2, 1] puts any number of buttons on each row, a shape Minecraft's own grid can't
do. With the bundled button pack, those buttons are drawn as RPG panels with a border coloured by
their type (quest, side quest, riddle, story, reward…). Players without the pack get [ text ].

The button pack goes into your server's pack
UltraDialogue doesn't send packs or open ports. On startup it puts its buttons inside the
plugin that builds your server's pack: ResourcePackManager, Nexo, Oraxen, ItemsAdder, CraftEngine
or EcoItems. No pack plugin? The ZIP is left in plugins/UltraDialogue/resourcepack/ with a
README. Native buttons and plain text never need a pack.
A button editor in game
/ud opens a menu to pick a dialogue and a node and edit its buttons: text, icon, size and
position, without opening a file. "Test" opens the dialogue as it's saved, "Save" writes only that
node's buttons.

NPCs and other players
- FancyNpcs: link a dialogue by NPC name and clicking the NPC opens it instead of its actions.
- Any entity can talk too, with a tag:
/tag @e[type=villager,limit=1,sort=nearest] add dialogue:merchant. - Bedrock (Geyser + Floodgate): dialogues show as Bedrock forms, with text buttons.
- Older clients joining through ViaVersion get the same conversation in chat, with clickable answers.
Commands
| Command | |
|---|---|
/ud |
Button editor |
/ud open <id> [player] [node] |
Open a dialogue (console and other plugins too) |
/ud reload · /ud list |
Reload · loaded dialogues and their NPCs |
/ud flags <player> · /ud affinity <player> [id] |
See or change flags and affinity |
/ud icons |
Every icon, drawn the way that player sees them |
Everything needs ultradialogue.admin (op). Players need no permission to talk.
Placeholders
%ultradialogue_affinity_<id>% and %ultradialogue_flag_<flag>%, for BeautyQuests requirements,
DeluxeMenus or anything else with PlaceholderAPI.
Compatibility
- One jar for Paper, Purpur and Folia, on 26.1, 26.2 and 26.3, with Java 25.
- Optional: FancyNpcs, PlaceholderAPI, DeluxeMenus, ViaVersion, BeautyQuests 2.1, Floodgate and a pack plugin for the RPG buttons.
- English and Spanish built in.
Drop the jar in plugins/ and start the server: three example dialogues are created
(/ud open example).
Full documentation: gupe.dev/wiki/ultradialogue
Open source (MIT) — Social Studio


