简体中文 · English
DialogMenu 是一个基于 Minecraft Dialog 的菜单插件。你可以用 YAML 制作玩家设置、NPC 对话、首领介绍和确认界面，把文字、图标与交互按钮放进同一套菜单中。
一个文件就是一个完整菜单，相关子页面统一写在 Pages 下。简单的设置界面按顺序排列控件，需要自己设计版式时则使用画布坐标。插件附带可直接修改的示例，方便从现有菜单开始制作。
以下为游戏内实拍，点击图片可查看原图。
| NPC 对话 | 首领介绍 | 任务列表 |
|---|---|---|
 |
 |
 |
| 角色图标与对话选项 | 背景故事、战斗建议与奖励 | 分类、分页与任务进度 |
| 场景 | 功能 |
|---|---|
| 玩家设置 | 开关、按钮、档位滑条、下拉选择框、搜索与分类导航 |
| 对话与确认 | 多页跳转、条件显示、选项状态、玩家指令与控制台指令 |
| 自定义画布 | 调整元素位置、文字宽度、颜色与贴图；文字支持 6–24 号字体和加粗 |
| 物品展示 | 显示原版或其他插件的真实物品，保留模型及悬停提示 |
| 任务列表演示 | 每页最多 5 项，包含分类、详情、进度、奖励图标和“已完成”分类 |
设置菜单支持简体中文、英文以及暗色、亮色主题，玩家的语言与主题选择会保存。二元选项可使用绿色开启、灰色关闭的小开关，也可以保留宽按钮。档位滑条通过点击刻度或两侧箭头切换。
菜单使用配置中的原始画布尺寸。显示不全时，可在 Minecraft 视频设置中调小 GUI 比例。
| 菜单 | 打开指令 | 用途 |
|---|---|---|
| 设置演示 | /dmenu open demo-settings |
与玩家设置相同的布局；开关、滑条和下拉框独立演示，无需业务插件 |
| 对话演示 | /dmenu open demo-dialogue |
NPC 对话和后续选项 |
| 首领演示 | /dmenu open demo-boss |
首领介绍、难度选择与进入确认 |
| 任务演示 | /dmenu open demo-quests |
任务分类、分页、详情与模拟领取 |
这些示例都能复制、改名和修改。首领确认不会自动召唤首领；任务演示不读取真实任务进度，也不发放物品或货币奖励。实际玩法可以通过按钮动作接入自己的插件。
demo-settings 的选项只在本次演示中生效，重新打开后重置；示例资产为固定数据。服务器已有的 settings 是真实玩家设置，继续使用原配置和入口。两者的状态彼此独立。设置模板说明。
DialogMenu 0.1.21 以 Paper 1.21.11 为最低编译 API，已在 Paper 1.21.11 / 26.2、Java 25 环境验证。1.21.11 完成了菜单协议交互与着色器编译检查，完整客户端画面仍需复核，详见兼容测试记录。菜单皮肤需要配套资源包，玩家使用原版客户端即可。
- 将插件 JAR 放入服务器的
plugins目录。0.1.21 起已内置配套资源，启动时导出到plugins/DialogMenu/resourcepack/DialogMenu-resourcepack.zip。 - 新安装默认使用
ResourcePack.Provider: Auto，按 CraftEngine → ItemsAdder → Nexo → Oraxen 的顺序选择已启用的资源管理插件，并将资源放入其源目录。再次启动会更新由 DialogMenu 管理的文件，保留服主修改过的文件；冲突会在控制台列出。 - 按控制台提示让所选插件重新构建并发送资源包。没有这些插件时，可手动启用导出的 ZIP，或配置 URL / External 发送方式。自动复制资源不会替代资源包的构建、托管和客户端加载；与 BetterHud 共用时仍需保留其原包并合并资源。
- 玩家加载资源包后，用
/dmenu或/settings打开默认菜单。新安装默认关闭加载回执检查；已配置的 CraftEngine / URL / External 方式及检查开关会保留。
发布版 0.1.20 及更早版本仍需另下载同版本资源包并手动合入。完整的自动安装目录、冲突处理和发送配置见资源包指南。
首次安装会生成默认配置和四个示例菜单。已有配置会保留，修改后可用 /dmenu check 检查，再用 /dmenu reload 应用；检查失败时继续使用上一份有效配置。
将下面的内容保存为 plugins/DialogMenu/menus/my-menu.yml，执行检查与重载后，用 /dmenu open my-menu 打开。文件名就是菜单 ID，无需额外注册。
Version: 1
Type: settings
Title: "我的菜单"
DefaultPage: appearance
Language: zh_cn
Theme: dark
MainMenu: [close]
Pages:
appearance:
Title: "界面设置"
Layout: [主题]
Icons:
主题:
Type: dropdown
Name: "菜单主题"
Bind: theme
Options:
dark: "暗色"
light: "亮色"Layout 决定控件顺序，Icons 定义内容与动作。名称和说明可以直接写中文，也可写 {zh_cn: 中文, en_us: English} 提供两种语言。需要移动每个元素或更换画布样式时，使用 Type: canvas，详见配置指南。
所有联动均为可选依赖，按菜单需要安装。
| 联动 | 用途 |
|---|---|
| PlaceholderAPI | 在文字中显示变量，或读取自定义开关和选项状态 |
| Ambience | 连接默认菜单中的环境音效、粒子及其整合的掉落、拾取设置；旧独立 LootBeam / PickupNotifier 也保留兼容 |
| CraftEngine | 提供自定义物品，并可负责资源包的构建与发送 |
| ItemBridge 物品源 | 支持内置 ItemBridge 版本的全部 39 种插件适配器，包括 Oraxen、ItemsAdder、SX-Item、NeigeItems、CraftEngine、MMOItems、Nexo 等；无需另装 ItemBridge |
物品源通过 Display.Material: "source:插件ID:物品ID" 配置。真实物品使用原生 Dialog 物品页面，物品模型需要对应插件的资源包。自由画布中的图标使用字体贴图，两者的配置方式见物品源指南。
| 指令 | 说明 |
|---|---|
/dmenu help |
查看帮助，管理员可见检查与重载指令 |
/dmenu、/settings |
打开配置中的默认菜单 |
/dmenu open <菜单> [页面] |
打开指定菜单或子页面 |
/dmenu check |
检查配置，不应用修改 |
/dmenu reload |
应用通过检查的配置，刷新已打开的菜单 |
/dmenu pack |
发送配置的 URL 资源包，或提示资源包的发送方 |
主命令是 /dialogmenu，也可使用 /dmenu。权限 playersettings.use 默认向所有玩家开放；playersettings.admin 用于检查与重载，默认 OP 拥有。权限名沿用旧版本，已有权限配置可继续使用。
文档目录：配置指南、旧版迁移资料与开发记录统一收录在 docs/。
中文详细 Wiki：阅读手册 · 离线网页版（下载后打开） · 完整目录。覆盖新版 menus 的两类菜单、配置字段、动作、变量、物品源、资源包与可复制示例。