开了服务器感觉写菜单很麻烦？现在DialogCanvas来啦！

DCMenu是面向服主的 Paper 原生 Dialog 菜单插件：在服务器电脑的浏览器可视化编辑，保存后在游戏中打开。内嵌 Web 服务和前端，单 JAR、文件存储、单管理员密码，无需独立网站或数据库。

功能概览

• 提示、确认、多按钮菜单；文字/物品正文、四类输入、按钮图标及悬浮提示。
• 中文三栏编辑器，拖拽、复制、排序、实时近似预览、撤销重做。
• 文字颜色、多色渐变和常用样式；复杂文本保留原文，不有损自动转换。
• 条件树、命令 player/op/console、经济买卖、自定义附魔/属性、玩家限购与冷却。
• 正式 JSON + 手动 YAML，同步基线、revision 冲突保护、浏览器草稿 YAML 导入导出。
• 唯一主菜单快捷入口（潜行＋交换副手，默认 Shift＋F）、管理命令、安全归档与审计。

环境要求

用途	要求
运行	Paper 26.1～26.3 系列、Java 25；已测 26.1.1/26.1.2/26.2/26.3，详见兼容表
浏览器	在服务器电脑访问实际 http://127.0.0.1:端口/；运行不需 Node/Vite/CDN
经济（可选）	Vault 兼容桥 + 真正经济提供者；仅装桥不能交易
PAPI（可选）	PlaceholderAPI + 对应变量扩展；不是任意 %...% 自动可用
从源码构建	JDK 25、Gradle Wrapper 9.4.0、Node.js 24.19.0（本轮环境）、pnpm 11.19.0，依赖需按锁文件安装

快速开始

1. 正常停服并备份；插件放入 plugins/，只保留一个 DCMenu JAR。不要在 服务器运行中覆盖后才 stop。
2. 启动。首次无哈希时控制台只显示一次安全随机密码；保存好，磁盘仅存 BCrypt 哈希。十份详细中文注释示例自动生成到 plugins/DialogCanvas/examples/menus/，附使用说明，按需导入即可使用。
3. 控制台执行 dcmenu editor，在服务器电脑打开实际地址，用密码登录。
4. 顶部“新建”，菜单标识填 wiki_first（已有同名就另选），保留多按钮类型及自带关闭按钮；右侧填标题，左侧添加“文字说明”。字段离开输入框提交。
5. “校验”→“保存”，等“保存全部完成”→“重新读取”核对；预览或颜色窗口“应用”都不等于正式保存。
6. 游戏管理员 /dcmenu open wiki_first，或控制台 dcmenu open wiki_first 完整在线玩家名。客户端实际显示请自行核对。

##完整逐步教程：文档入口

• [在线中文wiki]点击跳转至中文wiki

已知限制

仅 127.0.0.1，不提供公网编辑、RBAC/多账号、数据库、模板、历史、diff、WebSocket、游戏预览 API 或全服额度。网页是近似预览，原生结构布局而非自由坐标；复杂文本原文保护，当前无源码按钮。按钮 Sprite 不支持原生附魔闪光，所有材质不一定有图标。物品与按钮图标填写注册名（如 iron_ingot、minecraft:diamond_sword）；网页使用文字占位，JAR 不内嵌物品 PNG，实际纹理由游戏客户端提供。

正式 JSON 是依据；不要同时网页和手改同菜单，不运行中手改 JSON/同步基线。草稿仅页面内存，关闭/刷新不保证恢复。YAML 不保留注释/原排版，不转换 KaMenu 等其他插件格式。

经济/背包/文件不构成跨插件原子事务；补偿失败和不确定交易需人工核查，不删记录后重试。命令交给目标插件判断权限，临时 OP 仅同步调用期间恢复保障。注册名不能自动创建其他插件私有/模组物品。

许可证

DialogCanvas 采用 MIT License。Javalin、Jetty、Jackson 等内置组件仍分别受其上游许可证约束。