UltraDialogue

插件

· 作者 GupeLegend

带有分支选项的 NPC 对话界面,原生 Minecraft 对话框,无需资源包。

0 本站下载 0 关注 更新于 3 周前

需要前置:FancyNpcs

最新 1.1.4 · 26.3 · Folia / Paper

一键开服(送7天)

UltraDialogue

为 NPC 提供原生对话界面:包含角色肖像、台词以及以按钮形式呈现的玩家选项。每个选项都可以分支对话、打开菜单、执行命令或交付物品。

它使用了 Minecraft 1.21.6 添加的原生对话屏幕,因此无需安装客户端模组。

示例对话:带有 RPG 风格按钮的自由行,周围环绕着类型标识,以及底部的返回、奖励和退出行


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” 仅保存该节点的按钮配置。

/ud 编辑器:节点的按钮及其位置、图标、目标和所在行

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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源