DialogWindow

插件

· 作者 morelaid

适用于 1.21.6+ 版本的强大、完全可配置的对话框 UI 系统。通过 YAML 文件创建动态、交互式 GUI 对话框

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

最新 3.0.0 · 26.3 · Paper / Purpur

一键开服(送7天)

DialogWindow

将任意指令转化为整洁的游戏内 GUI —— 无需编写代码。

DialogWindow 允许服务器管理员使用简单的 YAML 文件为 Minecraft 构建完全自定义的对话框菜单。该插件基于 Minecraft 原生的 Dialog API(1.21.6+)构建,为原本仅在聊天栏显示文本的指令提供了真正的图形界面:按钮、复选框、下拉菜单、滑块、文本输入框以及自定义物品展示。

非常适合用于传送菜单、规则接受屏幕、商店确认、设置面板、权限等级选择、PvP 开关或任何值得拥有比一墙聊天文字更优雅界面的管理工具。

功能特性

  • 在 YAML 中定义整个 GUI —— 无需进行插件开发
  • 添加标签、按钮、复选框、选择菜单、滑块和文本输入框
  • 展示带有名称、描述、头颅纹理、发光效果等的自定义物品
  • 根据用户的选择触发控制台命令和玩家命令
  • 支持在任何地方插入 PlaceholderAPI 占位符 —— 标题、标签、物品描述、命令等
  • 通过子文件夹组织数十个菜单,井井有条
  • 兼容 Paper 和 Spigot

示例

Warp menu

Twitch settings

Twitch link

前置要求

  • Minecraft 1.21.6 或更高版本
  • Java 17 或更高版本
  • PlaceholderAPI(可选,但推荐安装)

由于该插件依赖 Minecraft 内置的 Dialog API,因此不支持旧版本。

快速开始

  1. 将 jar 文件放入 plugins 文件夹
  2. 重启服务器
  3. DialogWindow 会生成 config.yml、messages.yml 以及包含可用示例的 interfaces/ 文件夹
  4. 编辑或添加您自己的接口文件
  5. 运行 /dwreload —— 完成,无需重启服务器

指令

指令 功能 权限节点
/dw reload 动态重载配置、消息和所有接口 dialogwindow.reload
/dw open 手动打开一个已配置的对话接口 dialogwindow.open
/dw close 关闭当前打开的对话框 dialogwindow.close
/dw icons [filter] 显示图标列表(并非全部受支持) dialogwindow.icons
/dw report 生成诊断报告以用于技术支持请求 dialogwindow.report

手动打开与关闭

除了从您的接口文件中生成的自定义指令外,DialogWindow 还包含了 /dw open 和 /dw close。

当您希望在不运行其注册命令的情况下直接打开某个接口时,请使用 /dw open。这对于命令方块、NPC、其他插件、加入动作、管理工具或脚本化的服务器流程非常有用。

使用 /dw close 可以再次关闭活跃的对话框。这在切换菜单、清理脚本化流程或为管理员提供直接关闭玩家当前对话框的方式时非常有用。

快捷菜单与 ESC 菜单

DialogWindow 可以选择通过 Minecraft 的快捷菜单(Quick Menu)和 ESC 菜单(ESC Menu)暴露已配置的接口。

这使得重要的服务器菜单无需玩家记住指令即可访问。可用于枢纽导航、规则、设置、玩家资料、支持菜单、传送菜单或其他应始终易于访问的接口。

快捷菜单和 ESC 菜单条目是可选的,因此您可以决定哪些接口应出现在其中,而哪些接口仅保留为指令调用。

接口样式示例

interfaces/ 中的每个 YAML 文件定义一个指令及其对应的对话框。一个简单的传送菜单如下所示:

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

dialog:
  title: "<gold>Warp Menu</gold>"
  can-close-with-escape: false

ui:
  - label: "<yellow>Select your destination:</yellow>"

  - item:
      type: item
      material: PLAYER_HEAD
      name: "<gold>%playername%</gold>"
      skull-owner: "%playername%"
      glow: true

  - input:
      type: checkbox
      key: confirm
      label: "<green>Confirm teleport</green>"

  - buttons:
      - label: "<green>Teleport</green>"
        console-commands:
          - "warp ${destination}"

元素按从上到下的顺序渲染,与列出的顺序完全一致:标签、物品、输入框、按钮 —— 可以自由混合搭配。

可用的输入类型

  • text – 自由文本输入框
  • checkbox – 带自定义返回值的开/关切换
  • single_option – 选择菜单 / 下拉菜单
  • number_range – 带最小值/最大值/步长的滑块

物品展示(仅限 Paper)

材质、数量、名称、描述、头颅所有者、发光效果、自定义模型数据、附魔、物品标志、不可破坏性 —— 均可配置,且均支持占位符。

占位符

内置:%playername%、%uuid%、%world% 此外,如果在标题、标签、物品名称/描述、输入默认值、按钮命令和悬停文本中安装了 PlaceholderAPI,则完全支持 PAPI 的所有功能 —— 只要安装了 PAPI,它就能正常工作。

使用场景

传送菜单 · 商店确认 · 规则接受对话框 · PvP 开关 · 权限等级选择 · 设置面板 · 指令配置 UI · 管理工具

Web 编辑器

以可视化方式构建您的 YAML,而非手动编写:morelaid.com/dwe

支持

Discord:

在联系我们之前,请先运行 /dwreport 并将结果一并带来 —— 这将大大加快故障排除的速度。欢迎使用德语或英语提问。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源