DialogMenu 0.2.8

DialogMenu 0.2.8

LootBeam preference integration now prefers ItemLoom and retains independent LootBeam/Ambience fallback providers. PickupNotifier behavior is unchanged.

• 214 tests passed with 0 failures, including provider visibility and fallback tests.
• Public JAR contains no private HUD, wardrobe or validation assets.

This release contains only the verified JAR and SHA256SUMS.txt.

DialogMenu 0.2.7

DialogMenu 0.2.7

• 自定义物品展示改接 ItemLoom 公开服务：只读 ID 校验，按查看者生成物品，保留旧 NI 来源前缀适配。
• 描述文件依赖和当前物品源指南同步更新；移除 NeigeItems 来源入口，保留其它 ItemBridge 提供者。
• 构建声明保持各自精确 Paper 开发包及私有资源边界。

---

• 附件：DialogMenu-0.2.7.jar, DialogMenu-0.2.7-resourcepack.zip 与 SHA256SUMS.txt。
• SHA-256：fefddbd39d6814b09931f856136902bb80f396f21b970b596c47ea0ee6c3e093
• 历史 Release 保留，不用新附件覆盖旧版本。

DialogMenu 0.2.6

原生 Dialog 新增 14 个可复用图标动画预设：淡入／淡出、飞入／飞出、缩放进入／退出、回弹进入／退出、脉冲、抖动、摇摆、旋转、上浮淡入／淡出。不包含裁剪类效果。

/dmenu open demo-animation 打开演示，/dmenu open demo-animation spin 可直接选择预设；原生按钮支持上一个、下一个和重播。默认每个图标 20 tick、六图标错峰共 30 tick；animations.yml 可为每种预设分别设置 start、end、speed 和演示错峰间隔。实际结束 = start + (end - start) / speed。等待启动或进度不变时不重复发包，播放完成停止刷新。完全隐藏时不接受点击，切换／重播使用新令牌，关闭及外来页面接管会取消任务。

字体 JSON 直接引用已有纹理，14 个效果共用少量 shader 代码，不复制 PNG、不生成帧图。配套 ZIP 从 282,009 增至 283,500 字节，增加 1,491 字节；419 张既有 PNG 字节全部保持。复用现有透明边界字形保证现代客户端的显示与图标本体点击。

公共 Java 接口 AnimationPreset、AnimationTiming 和 DialogCanvas.animatedSprite(...) 可用于已有原版／CE 单张贴图。代码调用方可读取已加载的预设时间或为单个图标覆盖，并负责调度与取消；已有 YAML 菜单没有自动绑定图标的通用 Animation 字段。这是平面图标效果，完整 ItemStack 模型、附魔等不会自动应用。

验证：205 项 JUnit，31 项 Paper 协议断言（含固定启动、速率缩放和坏时间配置重载回滚），原版 26.3 字体 codec，14,336 项动画 GPU 变换与 512 项透明混合，原有中文字号和全屏 shader 回归、完整／瘦身 JAR 与本机消费者直接 API 检查，以及原版图形客户端显示、图标本体点击、切换、重播和 ESC。未测试其他客户端版本、第三方 shader 合包或多人压力。

配套 JAR 和资源 ZIP 必须一起更新，并让客户端重新加载资源包。公开包基于原版 26.3；与第三方 HUD 合包时需整包所有者组合两个动画 shader 入口，旧 compose_native_cjk.py 只覆盖中文字号。详见累计 CHANGELOG、RELEASE-VALIDATION 和 docs/guides/ANIMATION.md。附件均有 SHA256SUMS.txt。

DialogMenu 0.2.5

DialogMenu 0.2.5 的 Dialog 与全屏菜单复用原版客户端 Unihex 中文字库，保留 6–24 号字号、按钮基线、混合文字宽度、加粗和斜体。统一资源包从 2,938,669 字节降至 282,009 字节，减少 90.4%；删除 29 张中文字图集和各字号重复字符表。

BetterHud 合包时需要保留公开字体着色器入口，操作见字体与合包指南。本版本保留资源冲突检测和 External 发送入口；实际 BetterHud 组合包尚未验收。

• 正式版本，适用 Paper 26.3；不需要 TorakaHud。
• 196 项测试、41 个字体与 592 个 provider 的原版客户端解码、308 个 GPU 字体场景及全屏 GPU 回归通过。
• API 契约与 Shadow minimize 检查均为 0 问题。
• 附实际构建 JAR、唯一的 Dialog/全屏统一资源包和 SHA256SUMS.txt；JAR 内置资源包与独立 ZIP 逐字节相同。
• 累计更新日志与验证记录。历史版本及附件保留。

DialogMenu 0.2.4

DialogMenu 0.2.4 统一为一个插件 JAR 和一份资源包：Dialog 与全屏资源已合并，Assets 不再额外提供 DialogMenu-fullscreen.zip。

• 修正 Dialog GUI 着色器的 26.3 DynamicTransforms 布局与显式接口位置；不包含私人素材、衣帽间或 TorakaHud。
• 菜单文件首项选择 MenuType: dialog 或 MenuType: fullscreen，不能混用布局和按钮；不同菜单可互相跳转。
• Paper / 原版客户端 26.3、Java 25。全屏需配置 fullscreen.yml，目前为固定 diagnostic 测试布局；本地光标不等待回包，点击仍受网络/tick 影响。
• 沿用现有菜单与 fullscreen.yml；下载统一资源包替换原来两份菜单 ZIP。
• 完整构建、192 项单测、78 项协议断言、GPU 576 场景及七种分辨率的 112 帧抗锯齿检查通过；API/minimize 为 0 问题。未新增真人客户端最终观感和鼠标延迟验收。

附件只有正式 JAR、与内置字节相同的合并资源包 ZIP、SHA256SUMS.txt。累计源码见标签，历史版本保持。

完整验证与限制 · 配置与安装

DialogMenu 0.2.3

DialogMenu 0.2.3 将 Dialog 与全屏方案整合到同一个插件中，安装一个 JAR 即可。

• 菜单文件第一个配置项指定 MenuType: dialog 或 MenuType: fullscreen；禁止同文件混用布局和按钮类型，不同菜单可以互相跳转。
• 新增 /dmenu open demo-fullscreen：本地绘制黄色光标和悬停高亮、抗锯齿、1920×1080 背景按窗口铺满。只提供固定诊断布局，尚不支持任意 YAML 全屏背景或按钮。
• 无客户端 Mod、无额外全屏插件、无 TorakaHud 依赖。全屏需要 Paper / 原版客户端 26.3 和配套资源包；首次使用在 fullscreen.yml 配置玩家可访问的 pack-url。
• 统一菜单切换与重载；失败保留旧状态，迟到资源包回执不会重新弹出全屏。点击动作仍受网络和服务器 tick 影响。
• 累计菜单类型校验、文档/示例/生成器更新与冗余代码清理；历史版本及附件保留。

升级前为已有菜单补 MenuType: dialog，不要给 Version 3 全局 config.yml 添加该字段。

验证：192 项单测、78 条隔离 Paper 协议断言、API/minimize 检查通过；GPU 28 种着色器变体、576 个视角场景和 7 种分辨率通过。未完成原版 26.3 图形客户端人工验收、真实鼠标延迟测量或全屏与第三方 HUD/光影组合验证。

配置指南 · 完整更新日志 · 验证与限制

附件中的两份 ZIP 与 JAR 内置资源逐字节相同；可用 SHA256SUMS.txt 校验下载。

DialogMenu 0.2.2

本版累计更新设置菜单与模板美术，并修复任务菜单的关闭符号和奖励行排版。

• 设置菜单采用原创灰石面板、按钮、开关、滑块与 10 枚独立 16×16 原创图标，更贴近原版像素风格。
• 首领、NPC 对话、任务菜单及随包模板统一为 Skin: stone；旧皮肤名称、字形编号与菜单动作继续兼容。
• 移除旧服务器素材及其生成入口；提供原创 PNG 与 Blockbench 工程。字体与任务物品图标保留各自来源，物品图标引用客户端纹理。
• 任务关闭符号放大为粗体 X，保留 18×18 点击范围；奖励图标与文字垂直居中，并按实际宽度留白。
• 公开产物不包含私有衣帽间、HUD 实现或私人贴图。

验证：176 项单元测试、完整构建、Shadow 瘦身检查通过；Paper 26.3 build 142 菜单交互验证通过。预览为实际组件的离线像素绘制，真人客户端最终观感尚未复核。

升级时使用本版 JAR 与配套资源。CraftEngine 服主应移除其他资源源中的旧菜单重复副本，再执行 /ce reload all 与 /ce workflow default，让客户端接收新包。

附件：DialogMenu-0.2.2.jar、DialogMenu-resourcepack-0.2.2.zip、quest-menu-2x.png、SHA256SUMS.txt。独立资源包与 JAR 内置资源逐字节相同。

累计更新日志 · 验证记录

DialogMenu 0.2.0

DialogMenu 0.2.0 正式版

本版本面向 Paper 26.3，使用 Java 25 构建并输出 Java 21 字节码。

• Paper API：26.3.build.142-beta
• Paper 服务端：26.3-142-main@1c92a6c
• 176 项 JUnit 测试通过，113 个 Java 文件格式检查通过。
• Paper 26.3-142 干净沙盒启动、加载 4 个内置菜单并正常停服。
• 公开版不包含私有 DialogMenu-private 的衣帽间功能。

附件：

• DialogMenu-0.2.0.jar
• SHA256SUMS-0.2.0.txt

JAR SHA-256：44b3fd923fe38c5e1586f021744c9a0160674d827cbd14dc0e982bf24ecba479

DialogMenu 0.2.0-paper.4-SNAPSHOT

DialogMenu 0.2.0-paper.4-SNAPSHOT 累计更新

• 公开通用版迁移为纯 Java/Paper 并内置 Keystone 0.3.5，保留公共 API、ItemBridge、菜单格式及公开资源。
• 累计加入 canvas Placeholders、PAPI 数值比较、图片 Sprite 和条件 Cases，打开、刷新和点击时按规则复核条件。
• settings 与 canvas 共用 TrMenu 式动作及条件块，支持提示、指令、声音、延迟和跳转；按钮宽度可设 16–960 像素。
• 菜单、设置和语言原子重载，失败保持模型、缓存、会话和资源，不改文件、不备份；/dmenu check 只读。
• 启动坏内置内容核验原字节备份后恢复，自建坏内容原样跳过；语言/更新设置失败保留旧头及日志并锁写。
• 统一后台详情、执行者短摘要及累计三次管理员提醒；公开源码、JAR、资源包和附件不含私有 HUD、衣帽间或私人贴图。

本次为累计源码迁移与重构发布，历史变更保留在 CHANGELOG.md。

验证范围与限制见 RELEASE-VALIDATION.md。使用已经构建并验证的精确 JAR，发布阶段未重新执行测试。

• JAR：DialogMenu-0.2.0-paper.4-SNAPSHOT.jar
• SHA-256：c4bc65a7f4e018ef39e65acc17032bd157031ad24922fc1c990cdcdee6711d84
• 附件：JAR 与 SHA256SUMS.txt。

此版本为预发布，未设置为 latest。

DialogMenu 0.1.22

DialogMenu 0.1.22

0.1.22 正式发布，累计包含已验证的功能与修复，保留历史版本和预发布附件。

• 支持 <image:命名空间:图片ID>、显式 CE/CraftEngine 与 IA/ItemsAdder 前缀，以及 CE 图集行列。
• 翻译由 DialogMenu 的 text.yml 和 translations/*.yml 管理：i18n 使用默认语言，l10n 使用玩家客户端语言并回退，无须修改 CE 翻译配置。
• 包含 0.1.21 的通用兼容与资源自动导入功能，以及后续放宽合法输入根目录联接的路径检查修复；保留目录内越界保护。
• 附中文 Wiki、图片/物品来源说明和可复制的多语言菜单示例。

验证

• 106 项测试通过，0 失败；源码格式检查通过。
• 实际发布 JAR 在独立 Paper 26.2 build 123 + CraftEngine 26.9.1 通过真实图片、多语言、配置检查和重载前后探针。
• 功能代码与用户已测试版本一致，以正式版本号重新构建并验证；此前 Minecraft 26.2 截图已确认中文翻译、玩家名参数和两种 CE 图片写法正常。

尚待实测

真实 ItemsAdder 联动和客户端切换语言后的画面尚待用户验证；不将这两项标记为已验收。

附件包含实际测试的 JAR、从该 JAR 提取的同一资源包、对应提交的源码 ZIP，以及覆盖全部附件的 SHA256SUMS.txt。