Music HUD

Compatibility

Incompatible with 1.2.x and lower

NOT recommend for servers to deploy this version as network protocol might change anytime during alpha / beta period

Client

Feature

• Add / Remove track to like-list / playlist
• Subscribe or unsubscribe playlist / album / artist

Improve

Architect

• Refactored multiple services & systems with better stability

GUI

• Reworked music collection card with visible items count, played count (for playlist), album type (for album), (un)subscribe icon button and push-to-idle-play-source icon button
• Redesigned buttons and layout with icons generally
• Improved account view to split user's like-list, playlist created by user, playlist subscribed by user
• Improved top bar of music detail view and artist detail view to show the same info and buttons as the card does
• Improved scroll performance of music collection view (Known issue: item with visible tooltip scrolling out viewport will cause NPE, already fixed at code base, waiting for next release)
• Improved router container with child view lazy load
• Search playlist / album result page now using waterfall
• Animated background color for clickable elements
• Music list item now showing Premium tag

HUD

• Updated default values to provide better default appearance and layout
• Minecraft 26.2 only: Force glyph render state to use FilterMode.LINEAR globally to improve scaled text render quality

Audio

• Stream audio player now can auto-resync when the JVM resumes from suspension (GC or otherwise)

Fix

GUI

• When removing a track from the global queue that has an identical nearby track, the UI will always remove the last item
• Unable to set negative values in options that should allow them
• Some default values in the config view mismatch their definitions
• Minecraft 26.2 only: In the ModernUI fork Chino081/ModernUI-MC, global decor view is invisible, causing toast invisible without ModernUI screen
• Minecraft 26.2 only: In the ModernUI fork Chino081/ModernUI-MC, alpha value is multiplied twice, causing incorrect visuals

Server

Feature

• Paper edition no longer depends on vanilla Minecraft, which is suitable for a wide range of versions and compatible with ViaVersion, and also reduces package size
• Add / Remove track to like-list / playlist
• Subscribe or unsubscribe playlist / album / artist

Improve

Architect

• Refactored multiple services & systems with better stability

---

兼容性

与 1.2.x 及以下版本不兼容

不推荐服务器部署该版本，因为 alpha / beta 阶段可能随时会修改网络协议

客户端

新增功能

• 支持将歌曲添加/移除至喜欢列表/歌单
• 支持订阅或取消订阅歌单 / 专辑 / 歌手

优化

架构

• 重构了多个服务与系统，提升了稳定性

GUI

• 重做音乐收藏卡片：显示曲目数量、播放次数（歌单）、专辑类型（专辑）、订阅/取消订阅图标按钮，以及推送到空闲播放源图标按钮
• 全面重新设计按钮及其布局，大范围使用图标
• 改进了账号视图，将用户喜欢列表、用户创建的歌单、用户订阅的歌单分别展示
• 改进音乐详情视图与歌手详情视图的顶栏，显示与卡片相同的信息和按钮
• 提升音乐收藏视图的滚动性能（已知问题：在工具提示可见的项目滚动出视口会导致空指针异常，已在代码库中修复，等待下一次发布）
• 改进路由容器，支持子视图懒加载
• 歌单 / 专辑搜索结果页改用瀑布流布局
• 为可点击元素添加背景色动画
• 音乐列表项现在会显示 VIP 标签

HUD

• 更新默认值，提供更好的默认外观与布局
• 仅 Minecraft 26.2：强制全局字形渲染使用 FilterMode.LINEAR，提升缩放文本的渲染质量

音频

• 流式音频播放器现可在 JVM 从挂起状态（如 GC 等）恢复时自动重新同步

修复

GUI

• 从全局队列中移除歌曲时，若前后存在相同歌曲，总是移除最后一项
• 部分应支持负值的选项无法设置负值
• 配置视图中部分默认值与定义不符
• 仅 Minecraft 26.2：在 ModernUI fork（Chino081/ModernUI-MC）中，全局 decor view 不可见导致 toast 在无 ModernUI 屏幕时不可见
• 仅 Minecraft 26.2：在 ModernUI fork（Chino081/ModernUI-MC）中，透明度被重复乘算，导致视觉效果异常

服务端

新增功能

• Paper 版本不再依赖原版 Minecraft，适用于更广泛的版本范围，兼容 ViaVersion，同时减小了包体积
• 支持将歌曲添加/移除至喜欢列表/歌单
• 支持收藏或取消收藏歌单 / 专辑 / 歌手

优化

架构

• 重构了多个服务与系统，稳定性显著提升