UltraDialogue
为 NPC 提供原生对话界面:包含角色肖像、台词以及以按钮形式呈现的玩家选项。每个选项都可以分支对话、打开菜单、执行命令或交付物品。
它使用了 Minecraft 1.21.6 添加的原生对话屏幕,因此无需安装客户端模组。

YAML 格式对话
dialogues/ 目录下每个角色对应一个文件。定义节点、答案以及每个答案的跳转目标:
name: '&2&lThe Wandering Merchant'
npcs: [merchant] # FancyNpcs NPC 名称
portrait: 'npc | item:EMERALD' # NPC 皮肤,若没有则显示绿宝石
start:
- if: '!flag:met_merchant' # 初次见面...
node: intro
- node: hello # ...以及之后的每次见面
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
功能特性
- 任意选项的动作:跳转到另一个节点或对话、打开菜单、执行玩家或控制台命令、发送消息、标题或动作栏提示、播放音效。
- 条件限制:隐藏或锁定选项,支持权限检查、玩家标记(flags)、好感度、BeautyQuests 任务以及任何 PlaceholderAPI 占位符(如
%vault_eco_balance% >= 1000)。
- 锁定选项:显示为灰色并附带提示,返回按钮记录路径,退出按钮固定在底部。
- 好感度系统:每位玩家与每个角色拥有独立的好感度等级。友善的回答提升好感,粗鲁的回答降低好感,随着好感度增长会解锁新的问候语和秘密内容。
- 不重复的对话:每行可设置多个变体,问题随机轮换。
- 物品交付:检查、收取和给予物品(包括原版物品、UltraBoss 战利品、UltraRevive 复活图腾或通过隐藏标签、模型或名称指定的任何物品)。收取操作为全有或全无,并在点击时再次校验。
- 玩家标记:用于记录玩家已完成的操作,数据存储在玩家端(无需数据库)。
- 肖像支持:支持 NPC 皮肤、任意玩家皮肤、纹理贴图或任意物品。
自由行与 RPG 风格按钮
layout: [1, 2, 2, 1] 允许在每一行放置任意数量的按钮,这是 Minecraft 原生网格无法实现的布局。配合内置的按钮包,这些按钮将被渲染为带有边框的 RPG 面板,边框颜色根据类型(任务、支线任务、谜题、剧情、奖励等)而变化。未安装按钮包的玩家将看到 [ text ] 格式的文本。

按钮包集成至服务器资源包
UltraDialogue 不会发送资源包或开放端口。启动时,它会将按钮资源注入到构建服务器资源包的插件中:ResourcePackManager、Nexo、Oraxen、ItemsAdder、CraftEngine 或 EcoItems。如果没有资源包插件,ZIP 文件将保留在 plugins/UltraDialogue/resourcepack/ 目录中,并附带 README 说明。原生按钮和普通文本无需资源包即可正常工作。
游戏内按钮编辑器
输入 /ud 打开菜单,选择对话和节点,直接编辑其按钮的文字、图标、大小和位置,无需打开文件。“Test” 会以保存的状态预览对话,“Save” 仅保存该节点的按钮配置。

NPC 与其他实体
- FancyNpcs:通过 NPC 名称链接对话,点击该 NPC 将直接打开对话而非执行默认动作。
- 任意实体:均可通过标签进行对话,例如:
/tag @e[type=villager,limit=1,sort=nearest] add dialogue:merchant。
- 基岩版(Geyser + Floodgate):对话将以基岩版表单形式展示,包含文本按钮。
- 旧版客户端(通过 ViaVersion 加入):将在聊天窗口中看到相同的对话,并支持点击选项。
命令
| 命令 |
说明 |
/ud |
按钮编辑器 |
/ud open <id> [player] [node] |
打开对话(支持控制台和其他插件调用) |
/ud reload · /ud list |
重载 · 查看已加载的对话及其关联的 NPC |
/ud flags <player> · /ud affinity <player> [id] |
查看或修改标记和好感度 |
/ud icons |
查看该玩家视角下的所有图标渲染效果 |
所有命令均需 ultradialogue.admin 权限(OP)。玩家无需额外权限即可参与对话。
占位符
%ultradialogue_affinity_<id>% 和 %ultradialogue_flag_<flag>%,可用于 BeautyQuests 需求条件、DeluxeMenus 或其他支持 PlaceholderAPI 的功能。
兼容性
- 单个 JAR 文件兼容 Paper、Purpur 和 Folia,适用于 26.1、26.2 和 26.3 版本,需 Java 25。
- 可选依赖:FancyNpcs、PlaceholderAPI、DeluxeMenus、ViaVersion、BeautyQuests 2.1、Floodgate 以及用于 RPG 按钮的资源包插件。
- 内置英文和西班牙文。
将 JAR 文件放入 plugins/ 目录并启动服务器:系统将创建三个示例对话(使用 /ud open example 打开)。
完整文档: gupe.dev/wiki/ultradialogue
开源 (MIT) — Social Studio
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧