Music HUD

Compatibility

Incompatible with 1.3.0 prerelease 1 and below

Plugin hotfix

- Fixed UpdateAllIdlePlaySourceMessage <details> <summary> Compare to 1.3.0 prerelease 1 </summary>

Client

Improve

- User collections loading exception handling - Adjusted download stall watchdog timeout to prevent potential dead loop - Next-to-play track switch animation in home page - Sidebar music info card duration text set timing - Lyrics animation interpolator

Fix

- A music switch time resync bug causes long delay after a song finishes when join a world in some situations - A HUD lyric render bug causes the first line of songs' start missing - Sidebar album image won't scale smaller when muted by certain ways - Several minor problems of staggered lyric scroll view - Hud config screen drag jitter - Pusher info view missing in the queue list of home page - Hud render manager registered duplicate listeners - Too strict enum handling when processing JSON --- </details> <details> <summary> Compare to 1.2.15.1 </summary>

Client

Feature

- Add / Remove track to like-list / playlist - Subscribe or unsubscribe playlist / album / artist - Sound Physics Perfected Compatibility - Audio smooth transition - Visual HUD config screen - NCM scrobble sync - Idle play source play mode: sequential | random | intelligent(like list only) - Lyric sidebar in GUI - VulkanMod Compatibility - Audio pipeline supports AL_EXT_FLOAT32 to provide better 24/32 bits audio stream quality - View tracks' idle source - Rotate next to play - Multichannel surround audio support - Scrobble play history page - NCM Cloud drive management

Improve

#### 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 - 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 - Better sidebar - Skip / Vote skip I18n - Config view layout - GUI animations - Units for played count in MusicCollectionDetailView and MusicCollectionCard - Icons in MusicCollectionDetailView and MusicCollectionCard - Improved StaggeredLyricScrollView implementation - MusicCollectionDetailView layout and extra info - ArtistDetailView layout - Sidebar and lyrics animations #### HUD - Updated default values to provide better default appearance and layout - Refactored pipelines - Improved lyrics transition easing - HUD background rendering - Hud render manager registered duplicate listeners #### Audio - Stream audio player now can auto-resync when the JVM resumes from suspension (GC or otherwise) - Refactored audio system - Improved JMTC handler - Audio pipeline - Audio preload #### Misc - Refactored multiple services & systems with better stability - Improved SoundEngineSppCompatMixin implementation - Switch GitHub repository url for API server fetching to official as they have build artifacts in release now - Special type playlist handling - Compatible with Raise Sound Limit Simplified - User premium tier detect - API server download dialog task handling - User collections loading exception handling - Too strict enum handling when processing JSON

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 #### Misc - NeoForge server cannot handle messages correctly - Null pointer exception occurs in search views when API service is unavailable - Playlist played count integer overflow

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 - Audio smooth transition - Scrobble

Improve

- Refactored multiple services & systems with better stability - User premium tier detect

Fix

- NeoForge server cannot handle messages correctly - Null pointer exception occurs in search views when API service is unavailable - Playlist played count integer overflow </details> ---

兼容性

与 1.3.0 prerelease 1 及以下不兼容

插件热修复

- 修复了“更新所有空闲播放源”消息 <details> <summary> 与 1.3.0 prerelease 1 对比 </summary>

客户端

改进

- 加载用户收藏错误处理 - 调整了音频下载冻结检测的超时时间以避免可能的死循环 - 主页下一首播放切换动画 - 侧边栏音乐信息中播放时长文本的设置时机 - 歌词动画插值器

修复

- 一个在某些情况下加入世界时出现的，导致了歌曲播放完毕后切换时出现长延迟的，音乐切换时间重同步问题 - 一个导致了 HUD 中某些曲目的首行歌词消失的歌词渲染 bug - 侧边栏中的封面图片在一些特定的静音情况下不会缩小 - 关于交错滚动歌词视图的一些小问题 - HUD 编辑页拖动抖动 - 在主页播放队列中的推送者信息消失 - HUD 渲染管理器注册了多个重复的监听器 - 处理 JSON 枚举时过于严格 --- </details> <details> <summary> 与 1.2.15.1 对比</summary>

客户端

新增功能

- 支持将歌曲添加/移除至喜欢列表/歌单 - 支持订阅或取消订阅歌单 / 专辑 / 歌手 - 与 Sound Physics Perfected 的兼容性 - 音频平滑过渡 - 可视化的 HUD 配置屏幕 - 网易云同步播放记录 - 空闲播放源播放模式：顺序循环 | 随机 | 心动模式（仅喜爱列表） - GUI 中的歌词侧边栏 - VulkanMod 兼容 - 音频管线支持 AL_EXT_FLOAT32 拓展以提高 24/32 bits 音频流播放质量 - 查看曲目的空闲播放源

优化

#### GUI - 重做音乐收藏卡片：显示曲目数量、播放次数（歌单）、专辑类型（专辑）、订阅/取消订阅图标按钮，以及推送到空闲播放源图标按钮 - 全面重新设计按钮及其布局，大范围使用图标 - 改进了账号视图，将用户喜欢列表、用户创建的歌单、用户订阅的歌单分别展示 - 改进音乐详情视图与歌手详情视图的顶栏，显示与卡片相同的信息和按钮 - 提升音乐收藏视图的滚动性能 - 改进路由容器，支持子视图懒加载 - 歌单 / 专辑搜索结果页改用瀑布流布局 - 为可点击元素添加背景色动画 - 音乐列表项现在会显示 VIP 标签 - 优化了侧边栏 - 跳过 / 投票跳过 相关国际化 - 配置页布局 - GUI 动画 - 歌曲集详细信息页和卡片中播放次数单位 - 歌曲集详细信息页和卡片中的图标 - 歌词滚动视图实现 - 歌单/专辑详细信息页布局和更多信息 - 歌手详细信息页布局 #### HUD - 更新默认值，提供更好的默认外观与布局 - 重构渲染管线 - 改进了歌词切换过渡缓动 - HUD 背景渲染 - Hud 渲染管理器注册了重复的监听器 #### 其他 - 重构了多个服务与系统，提升了稳定性 - 改进了 Sound Physics Perfected 兼容实现 - 将 API 服务器下载链接切换到官方仓库，因为目前发行版中已经有了二进制工件 - 与 Raise Sound Limit Simplified 兼容 - 音频管线 - 侧边栏和歌词动画 - 用户 VIP 级别检测 - API 服务器下载任务管理 - 处理 JSON 枚举时过于严格 #### 音频 - 流式音频播放器现可在 JVM 从挂起状态（如 GC 等）恢复时自动重新同步 - 重构音频系统 - 改进了 JMTC 相关处理 - 音频预加载

修复

#### GUI - 从全局队列中移除歌曲时，若前后存在相同歌曲，总是移除最后一项 - 部分应支持负值的选项无法设置负值 - 配置视图中部分默认值与定义不符 #### 其他 - NeoForge 服务端无法正确接收消息 - API 服务不可用时搜索出现空指针异常 - 歌单播放次数 int 溢出

服务端

新增功能

- Paper 版本不再依赖原版 Minecraft，适用于更广泛的版本范围，兼容 ViaVersion，同时减小了包体积 - 支持将歌曲添加/移除至喜欢列表/歌单 - 支持收藏或取消收藏歌单 / 专辑 / 歌手 - 音频平滑过渡 - 播放记录 - 重选下一首播放 - 播放历史记录页 - 网易云云盘管理

优化

- 重构了多个服务与系统，稳定性显著提升 - 用户 VIP 级别检测

修复

- NeoForge 服务端无法正确接收消息 - API 服务不可用时搜索出现空指针异常 - 歌单播放次数 int 溢出 --- </details>

Compatibility

Incompatible with 1.3.0 beta 2 and below

Client

Feature

- Rotate next to play - Multichannel surround audio support - Scrobble play history page - NCM Cloud drive management

Improve

- Compatible with Raise Sound Limit Simplified - HUD background rendering - Audio pipeline - MusicCollectionDetailView layout and extra info - ArtistDetailView layout - Sidebar and lyrics animations - User premium tier detect - API server download dialog task handling

Fix

- Network protocol error when connect to servers deployed 1.2.x and lower MusicHUD - A rare preload issue may cause silent EOF fail in mid-play

Server

Feature

- Rotate next to play - Scrobble play history page - NCM Cloud drive management

Improve

- User premium tier detect ---

兼容性

与 1.3.0 beta 2 及以前不兼容

客户端

新增功能

- 重选下一首播放 - 多声道环绕音频支持 - 播放历史记录页 - 网易云云盘管理

改进

- 与 Raise Sound Limit Simplified 兼容 - HUD 背景渲染 - 音频管线 - 歌单/专辑详细信息页布局和更多信息 - 歌手详细信息页布局 - 侧边栏和歌词动画 - 用户 VIP 级别检测 - API 服务器下载任务管理

修复

- 连接到 1.2.x 以及更低版本的服务端 MusicHUD 时出现网络协议错误 - 一个偶发的导致了静默 EOF 结束播放的预加载问题

服务端

新增功能

- 重选下一首播放 - 播放历史记录页 - 网易云云盘管理

改进

- 用户 VIP 级别检测

Client

Improve

- Error handling in multiple services

Fix

- API server fetcher uses wrong GitHub releases file name on Windows x64 - Idle play source sync issues when switching connection

Server

Platform

- Experimental Velocity support

Improve

- Error handling in multiple systems

Fix

- Idle play source sync issues when switching connection ---

客户端

改进

- 多个服务中的错误处理

修复

- API 服务器下载器在 64 位 Windows 上使用了错误的 GitHub 发行文件名 - 在切换连接时的一些空闲播放源同步问题

服务端

平台

- 实验性的 Velocity 支持

改进

- 多个服务中的错误处理

修复

- 在切换连接时的一些空闲播放源同步问题

Client

Fix

- Idle play source mode switching issues - Occational crash when open GUI - Occational crash on some game versions when Modern UI's modern text engine is off - Main GUI default page sometimes wrongs when opened by key binds

Improve

- Idle play source widget animations

Server

- Idle play source mode switching issues ---

客户端

修复

- 空闲播放源模式切换相关问题 - 打开 GUI 时偶发的崩溃 - 在某些游戏版本中禁用 ModernUI 的现代化文本引擎后可能崩溃 - 通过按键绑定打开主界面时默认页面可能错误

改进

- 空闲播放源控件动画

服务端

修复

- 空闲播放源模式切换相关问题

Compatibility

Incompatible with 1.3.0 alpha 2 and below

Client

Feature

- NCM scrobble sync - Idle play source play mode: sequential | random | intelligent(like list only) - Lyric sidebar in GUI - VulkanMod Compatibility - Audio pipeline supports AL_EXT_FLOAT32 to provide better 24/32 bits audio stream quality - View tracks' idle source

Improve

- GUI animations - Improved SoundEngineSppCompatMixin implementation - Improved StaggeredLyricScrollView implementation - Units for played count in MusicCollectionDetailView and MusicCollectionCard - Icons in MusicCollectionDetailView and MusicCollectionCard - Switch GitHub repository url for API server fetching to official as they have build artifacts in release now - Special type playlist handling

Fix

- NeoForge server cannot handle messages correctly - Null pointer exception occurs in search views when API service is unavailable - Playlist played count integer overflow

Server

Feature

- Scrobble

Fix

- NeoForge server cannot handle messages correctly - Null pointer exception occurs in search views when API service is unavailable - Playlist played count integer overflow ---

兼容性

与 1.3.0 alpha 2 及以下不兼容

客户端

新增功能

- 网易云同步播放记录 - 空闲播放源播放模式：顺序循环 | 随机 | 心动模式（仅喜爱列表） - GUI 中的歌词侧边栏 - VulkanMod 兼容 - 音频管线支持 AL_EXT_FLOAT32 拓展以提高 24/32 bits 音频流播放质量 - 查看曲目的空闲播放源

改进

- GUI 动画 - 改进了 Sound Physics Perfected 兼容实现 - 改进了歌词交错滚动视图实现 - 歌曲集详细信息页和卡片中播放次数单位 - 歌曲集详细信息页和卡片中的图标 - 将 API 服务器下载链接切换到官方仓库，因为目前发行版中已经有了二进制工件

修复

- NeoForge 服务端无法正确接收消息 - API 服务不可用时搜索出现空指针异常 - 歌单播放次数 int 溢出

服务端

新增功能

- 播放记录

修复

- NeoForge 服务端无法正确接收消息 - API 服务不可用时搜索出现空指针异常 - 歌单播放次数 int 溢出

Compatibility

Incompatible with 1.2.x and lower Compatible with 1.3.0 alpha, but may not providing best experience NOT recommend for servers to deploy this version as network protocol might change anytime during alpha / beta period

Client

Feature

- Sound Physics Perfected Compatibility - Audio smooth transition - Visual HUD config screen

Improve

#### GUI - Better sidebar, increased width - Skip / Vote skip I18n - Config view layout #### HUD - Refactored pipelines - Improved lyrics transition easing #### Audio - Refactored audio system - Improved JMTC handler

Fix

#### GUI - Items in music collection detail view with visible tooltip scrolling out viewport will cause NPE

Server

Feature

- Audio smooth transition ---

兼容性

与 1.2.x 及以下版本不兼容 与 1.3.0 alpha 兼容，但是可能不能提供最佳体验 不推荐服务器部署该版本，因为 alpha / beta 阶段可能随时会修改网络协议

客户端

新增功能

- 与 Sound Physics Perfected 的兼容性 - 音频平滑过渡 - 可视化的 HUD 配置屏幕

优化

#### GUI - 优化了侧边栏，增加了宽度 - 跳过 / 投票跳过 相关国际化 - 配置页布局 #### HUD - 重构渲染管线 - 改进了歌词切换过渡缓动 #### 音频 - 重构音频系统 - 改进了 JMTC 相关处理

修复

#### GUI - 在音乐收藏视图中，工具提示可见的项目滚动出视口会导致空指针异常

服务端

功能

- 音频平滑过渡

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，同时减小了包体积 - 支持将歌曲添加/移除至喜欢列表/歌单 - 支持收藏或取消收藏歌单 / 专辑 / 歌手

优化

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

Version

Experimentally supports 26.2, with both OpenGL and Vulkan supports Tested on a (buggy)[ModernUI fork](https://github.com/Chino081/ModernUI-MC/releases/tag/26.2) on Fabric ---

版本

对 26.2 的实验性支持，支持 OpenGL 和 Vulkan 已在一个（Bug 有点多的）[ModernUI 分支](https://github.com/Chino081/ModernUI-MC/releases/tag/26.2)的 Fabric 端上测试

Client

Feature

- API server download modal available in config view (with optional GH Proxy options) - API server log status in config view - Configurable API server environment variables - Render HUD in server reconfig screen and receiving level screen to provide smoother experience when switching between level and sub-server

Improve

- Added player head avatar switch transition - Reduced aliasing in HUD album image - Improved accuracy of HUD background - Improved stream audio player auto retry in play initialization - Improved music pusher log messages - Refactor: Reimplements player head view to image view in ModernUI - Refactor: Abstract network layer

Fix

- Potential deadlock when calls ImageUtils.getImageTextureData in "Render thread" - Media integration pause status did not update when switching mute - API Status refresh issues in config view

Server

Improve

- Improved music pusher log messages - Refactor: Abstract network layer ---

客户端

功能

- 设置页面中的 API 服务器下载模态框（含可选的 GH Proxy 加速选项） - 设置页面中的 API 服务器日志状态 - 可配置 API 服务器环境变量 - 在“重新配置中”和“加载地形中”页面绘制 HUD 以提供在切换维度、子服务器时更平滑的体验

改进

- 添加了玩家头像切换淡入淡出效果 - 减少了 HUD 专辑封面绘制时的锯齿 - 改进了 HUD 背景颜色准确性 - 改进了音频流播放器在初始化时的重试逻辑 - 改进了音乐推送服务的日志消息 - 重构：将 PlayerHeadView 用 ModernUI 的 ImageView 重新实现 - 重构：网络抽象层

服务端

改进

- 改进了音乐推送服务的日志消息 - 重构：网络抽象层

Client

Feature

- API server download modal available in config view (with optional GH Proxy options) - API server log status in config view - Configurable API server environment variables - Render HUD in server reconfig screen and receiving level screen to provide smoother experience when switching between level and sub-server

Improve

- Added player head avatar switch transition - Reduced aliasing in HUD album image - Improved accuracy of HUD background - Improved stream audio player auto retry in play initialization - Improved music pusher log messages - Refactor: Reimplements player head view to image view in ModernUI - Refactor: Abstract network layer

Fix

- Potential deadlock when calls ImageUtils.getImageTextureData in "Render thread" - Media integration pause status did not update when switching mute - API Status refresh issues in config view

Server

Improve

- Improved music pusher log messages - Refactor: Abstract network layer ---

客户端

功能

- 设置页面中的 API 服务器下载模态框（含可选的 GH Proxy 加速选项） - 设置页面中的 API 服务器日志状态 - 可配置 API 服务器环境变量 - 在“重新配置中”和“加载地形中”页面绘制 HUD 以提供在切换维度、子服务器时更平滑的体验

改进

- 添加了玩家头像切换淡入淡出效果 - 减少了 HUD 专辑封面绘制时的锯齿 - 改进了 HUD 背景颜色准确性 - 改进了音频流播放器在初始化时的重试逻辑 - 改进了音乐推送服务的日志消息 - 重构：将 PlayerHeadView 用 ModernUI 的 ImageView 重新实现 - 重构：网络抽象层

服务端

改进

- 改进了音乐推送服务的日志消息 - 重构：网络抽象层

Client

Feature

- API server download modal available in config view (with optional GH Proxy options) - API server log status in config view - Configurable API server environment variables - Render HUD in server reconfig screen and receiving level screen to provide smoother experience when switching between level and sub-server

Improve

- Added player head avatar switch transition - Reduced aliasing in HUD album image - Improved accuracy of HUD background - Improved stream audio player auto retry in play initialization - Improved music pusher log messages - Refactor: Reimplements player head view to image view in ModernUI - Refactor: Abstract network layer

Fix

- Potential deadlock when calls ImageUtils.getImageTextureData in "Render thread" - Media integration pause status did not update when switching mute - API Status refresh issues in config view

Server

Improve

- Improved music pusher log messages - Refactor: Abstract network layer ---

客户端

功能

- 设置页面中的 API 服务器下载模态框（含可选的 GH Proxy 加速选项） - 设置页面中的 API 服务器日志状态 - 可配置 API 服务器环境变量 - 在“重新配置中”和“加载地形中”页面绘制 HUD 以提供在切换维度、子服务器时更平滑的体验

改进

- 添加了玩家头像切换淡入淡出效果 - 减少了 HUD 专辑封面绘制时的锯齿 - 改进了 HUD 背景颜色准确性 - 改进了音频流播放器在初始化时的重试逻辑 - 改进了音乐推送服务的日志消息 - 重构：将 PlayerHeadView 用 ModernUI 的 ImageView 重新实现 - 重构：网络抽象层

服务端

改进

- 改进了音乐推送服务的日志消息 - 重构：网络抽象层

Client

Feature

- API server download modal available in config view (with optional GH Proxy options) - API server log status in config view - Configurable API server environment variables - Render HUD in server reconfig screen and receiving level screen to provide smoother experience when switching between level and sub-server

Improve

- Added player head avatar switch transition - Reduced aliasing in HUD album image - Improved accuracy of HUD background - Improved stream audio player auto retry in play initialization - Improved music pusher log messages - Refactor: Reimplements player head view to image view in ModernUI - Refactor: Abstract network layer

Fix

- Potential deadlock when calls ImageUtils.getImageTextureData in "Render thread" - Media integration pause status did not update when switching mute - API Status refresh issues in config view

Server

Improve

- Improved music pusher log messages - Refactor: Abstract network layer ---

客户端

功能

- 设置页面中的 API 服务器下载模态框（含可选的 GH Proxy 加速选项） - 设置页面中的 API 服务器日志状态 - 可配置 API 服务器环境变量 - 在“重新配置中”和“加载地形中”页面绘制 HUD 以提供在切换维度、子服务器时更平滑的体验

改进

- 添加了玩家头像切换淡入淡出效果 - 减少了 HUD 专辑封面绘制时的锯齿 - 改进了 HUD 背景颜色准确性 - 改进了音频流播放器在初始化时的重试逻辑 - 改进了音乐推送服务的日志消息 - 重构：将 PlayerHeadView 用 ModernUI 的 ImageView 重新实现 - 重构：网络抽象层

服务端

改进

- 改进了音乐推送服务的日志消息 - 重构：网络抽象层

Client

Feature

- API server download modal available in config view (with optional GH Proxy options) - API server log status in config view - Configurable API server environment variables - Render HUD in server reconfig screen and receiving level screen to provide smoother experience when switching between level and sub-server

Improve

- Added player head avatar switch transition - Reduced aliasing in HUD album image - Improved accuracy of HUD background - Improved stream audio player auto retry in play initialization - Improved music pusher log messages - Refactor: Reimplements player head view to image view in ModernUI - Refactor: Abstract network layer

Fix

- Potential deadlock when calls ImageUtils.getImageTextureData in "Render thread" - Media integration pause status did not update when switching mute - API Status refresh issues in config view

Server

Improve

- Improved music pusher log messages - Refactor: Abstract network layer ---

客户端

功能

- 设置页面中的 API 服务器下载模态框（含可选的 GH Proxy 加速选项） - 设置页面中的 API 服务器日志状态 - 可配置 API 服务器环境变量 - 在“重新配置中”和“加载地形中”页面绘制 HUD 以提供在切换维度、子服务器时更平滑的体验

改进

- 添加了玩家头像切换淡入淡出效果 - 减少了 HUD 专辑封面绘制时的锯齿 - 改进了 HUD 背景颜色准确性 - 改进了音频流播放器在初始化时的重试逻辑 - 改进了音乐推送服务的日志消息 - 重构：将 PlayerHeadView 用 ModernUI 的 ImageView 重新实现 - 重构：网络抽象层

服务端

改进

- 改进了音乐推送服务的日志消息 - 重构：网络抽象层

Client

Improve

- Player avatar head in idle play source card and music list item - Add debounce on some operation

Fix

- Several idle play source sync issues - Integrated server network dispatch to other players, resolving LAN multiplayer unusable

Server

Fix

- Several idle play source sync issues - Broken integrated server network dispatch, resolving LAN multiplayer unusable ---

客户端

改进

- 在闲置播放源卡片和音乐列表项上添加了玩家头像 - 为一些操作添加了防抖

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

服务端

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

Client

Improve

- Player avatar head in idle play source card and music list item - Add debounce on some operation

Fix

- Several idle play source sync issues - Integrated server network dispatch to other players, resolving LAN multiplayer unusable

Server

Fix

- Several idle play source sync issues - Broken integrated server network dispatch, resolving LAN multiplayer unusable ---

客户端

改进

- 在闲置播放源卡片和音乐列表项上添加了玩家头像 - 为一些操作添加了防抖

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

服务端

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

Client

Improve

- Player avatar head in idle play source card and music list item - Add debounce on some operation

Fix

- Several idle play source sync issues - Integrated server network dispatch to other players, resolving LAN multiplayer unusable

Server

Fix

- Several idle play source sync issues - Broken integrated server network dispatch, resolving LAN multiplayer unusable ---

客户端

改进

- 在闲置播放源卡片和音乐列表项上添加了玩家头像 - 为一些操作添加了防抖

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

服务端

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

Client

Improve

- Player avatar head in idle play source card and music list item - Add debounce on some operation

Fix

- Several idle play source sync issues - Integrated server network dispatch to other players, resolving LAN multiplayer unusable

Server

Fix

- Several idle play source sync issues - Broken integrated server network dispatch, resolving LAN multiplayer unusable ---

客户端

改进

- 在闲置播放源卡片和音乐列表项上添加了玩家头像 - 为一些操作添加了防抖

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

服务端

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

Client

Improve

- Player avatar head in idle play source card and music list item - Add debounce on some operation

Fix

- Several idle play source sync issues - Integrated server network dispatch to other players, resolving LAN multiplayer unusable

Server

Fix

- Several idle play source sync issues - Broken integrated server network dispatch, resolving LAN multiplayer unusable ---

客户端

改进

- 在闲置播放源卡片和音乐列表项上添加了玩家头像 - 为一些操作添加了防抖

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

服务端

修复

- 一些空闲播放源同步问题 - 集成服务端的网络数据包分发逻辑错误，解决了局域网游戏中不可用的问题

Client

Fix

- Client network protocol error occurred when using isolated mode to join a server in isolated mode

Improve

- Async event hooks

Server

Improve

- Async event hooks ---

客户端

修复

- 客户端以隔离模式加入到服务器时出现网络协议错误

改进

- 异步事件钩子

服务端

改进

- 异步事件钩子

Client

Fix

- Client network protocol error occurred when using isolated mode to join a server in isolated mode

Improve

- Async event hooks

Server

Improve

- Async event hooks ---

客户端

修复

- 客户端以隔离模式加入到服务器时出现网络协议错误

改进

- 异步事件钩子

服务端

改进

- 异步事件钩子

Client

Fix

- Client network protocol error occurred when using isolated mode to join a server in isolated mode

Improve

- Async event hooks

Server

Improve

- Async event hooks ---

客户端

修复

- 客户端以隔离模式加入到服务器时出现网络协议错误

改进

- 异步事件钩子

服务端

改进

- 异步事件钩子

Client

Fix

- Client network protocol error occurred when using isolated mode to join a server in isolated mode

Improve

- Async event hooks

Server

Improve

- Async event hooks ---

客户端

修复

- 客户端以隔离模式加入到服务器时出现网络协议错误

改进

- 异步事件钩子

服务端

改进

- 异步事件钩子

Client

Fix

- Client network protocol error occurred when using isolated mode to join a server in isolated mode

Improve

- Async event hooks

Server

Improve

- Async event hooks ---

客户端

修复

- 客户端以隔离模式加入到服务器时出现网络协议错误

改进

- 异步事件钩子

服务端

改进

- 异步事件钩子

Client

Feature

- Adapted to SPlayer-Dev/ncm-api-rs, which faster than original NodeJS version but may unstable - Player skin's head rendering in main GUI

Improve

- Force bypassing OpenAL Soft HRTF filter to improve audio quality when HRTF is enabled - Player skin hot-refresh

Fix

- AutoConnectServerFilterType config defined default value (white-list) not matches to ui default value (black-list) - UI refreshing issue when EnableIsolatedMode config switched

Server

Fix

- Crash on NeoForge server when launch - Paper packaging version ---

客户端

功能

- 适配 SPlayer-Dev/ncm-api-rs（Rust 版 NCM API），比原 NodeJS 版更快，但可能不稳定 - 玩家皮肤头像在主界面中渲染

改进

- 强制绕过 OpenAL Soft HRTF 滤波器以提高在 HRTF 启用时的音质 - 玩家皮肤热刷新

修复

- 服务器自动连接过滤方式选项默认值（白名单）与 UI 显示的默认值（黑名单）不同 - UI 未在启用隔离模式选项改变后刷新

服务端

修复

- NeoForge 服务器启动时崩溃 - Paper 打包版本号错误

Client

Feature

- Adapted to SPlayer-Dev/ncm-api-rs, which faster than original NodeJS version but may unstable - Player skin's head rendering in main GUI

Improve

- Force bypassing OpenAL Soft HRTF filter to improve audio quality when HRTF is enabled - Player skin hot-refresh

Fix

- AutoConnectServerFilterType config defined default value (white-list) not matches to ui default value (black-list) - UI refreshing issue when EnableIsolatedMode config switched

Server

Fix

- Crash on NeoForge server when launch - Paper packaging version ---

客户端

功能

- 适配 SPlayer-Dev/ncm-api-rs（Rust 版 NCM API），比原 NodeJS 版更快，但可能不稳定 - 玩家皮肤头像在主界面中渲染

改进

- 强制绕过 OpenAL Soft HRTF 滤波器以提高在 HRTF 启用时的音质 - 玩家皮肤热刷新

修复

- 服务器自动连接过滤方式选项默认值（白名单）与 UI 显示的默认值（黑名单）不同 - UI 未在启用隔离模式选项改变后刷新

服务端

修复

- NeoForge 服务器启动时崩溃 - Paper 打包版本号错误

Client

Feature

- Adapted to SPlayer-Dev/ncm-api-rs, which faster than original NodeJS version but may unstable - Player skin's head rendering in main GUI

Improve

- Force bypassing OpenAL Soft HRTF filter to improve audio quality when HRTF is enabled - Player skin hot-refresh

Fix

- AutoConnectServerFilterType config defined default value (white-list) not matches to ui default value (black-list) - UI refreshing issue when EnableIsolatedMode config switched

Server

Fix

- Crash on NeoForge server when launch - Paper packaging version ---

客户端

功能

- 适配 SPlayer-Dev/ncm-api-rs（Rust 版 NCM API），比原 NodeJS 版更快，但可能不稳定 - 玩家皮肤头像在主界面中渲染

改进

- 强制绕过 OpenAL Soft HRTF 滤波器以提高在 HRTF 启用时的音质 - 玩家皮肤热刷新

修复

- 服务器自动连接过滤方式选项默认值（白名单）与 UI 显示的默认值（黑名单）不同 - UI 未在启用隔离模式选项改变后刷新

服务端

修复

- NeoForge 服务器启动时崩溃 - Paper 打包版本号错误

Client

Feature

- Adapted to SPlayer-Dev/ncm-api-rs, which faster than original NodeJS version but may unstable - Player skin's head rendering in main GUI

Improve

- Force bypassing OpenAL Soft HRTF filter to improve audio quality when HRTF is enabled - Player skin hot-refresh

Fix

- AutoConnectServerFilterType config defined default value (white-list) not matches to ui default value (black-list) - UI refreshing issue when EnableIsolatedMode config switched

Server

Fix

- Crash on NeoForge server when launch - Paper packaging version ---

客户端

功能

- 适配 SPlayer-Dev/ncm-api-rs（Rust 版 NCM API），比原 NodeJS 版更快，但可能不稳定 - 玩家皮肤头像在主界面中渲染

改进

- 强制绕过 OpenAL Soft HRTF 滤波器以提高在 HRTF 启用时的音质 - 玩家皮肤热刷新

修复

- 服务器自动连接过滤方式选项默认值（白名单）与 UI 显示的默认值（黑名单）不同 - UI 未在启用隔离模式选项改变后刷新

服务端

修复

- NeoForge 服务器启动时崩溃 - Paper 打包版本号错误

Client

Feature

- Adapted to SPlayer-Dev/ncm-api-rs, which faster than original NodeJS version but may unstable - Player skin's head rendering in main GUI

Improve

- Force bypassing OpenAL Soft HRTF filter to improve audio quality when HRTF is enabled - Player skin hot-refresh

Fix

- AutoConnectServerFilterType config defined default value (white-list) not matches to ui default value (black-list) - UI refreshing issue when EnableIsolatedMode config switched

Server

Fix

- Crash on NeoForge server when launch - Paper packaging version ---

客户端

功能

- 适配 SPlayer-Dev/ncm-api-rs（Rust 版 NCM API），比原 NodeJS 版更快，但可能不稳定 - 玩家皮肤头像在主界面中渲染

改进

- 强制绕过 OpenAL Soft HRTF 滤波器以提高在 HRTF 启用时的音质 - 玩家皮肤热刷新

修复

- 服务器自动连接过滤方式选项默认值（白名单）与 UI 显示的默认值（黑名单）不同 - UI 未在启用隔离模式选项改变后刷新

服务端

修复

- NeoForge 服务器启动时崩溃 - Paper 打包版本号错误

Client

Feature

- Windows SMTC & Linux MPRIS (have not fully test yet) support - Advanced sound volume control (mix and hotkeys) - Configurable mix alpha for HUD background themed colors - Reactive Music compatibility

Improve

- Using TPDF resample on 24/32 bits audio - Audio quality on 1.21.1 - Lyric animations - Refactors render pipelines on 1.21.1 - Modern string splitter fallback - Hud fluid background noise scaling - Expands position offsets range in config - Changes album image thumbnail size to avoid aliasing in main GUI - Using icons on "back" button in "music collection detail view" and "artist detail view"

Fix

- A toast canceling issue occurred in Modern UI 3.12.0 for 1.21.9 ~ 1.21.11 (mVUS fork) - Text renderer clip wrongly in some situations

Server

Fix

- Some game version wrongly marked as incompatible due to Paper "api-version" ---

客户端

功能

- 支持 Windows SMTC 与 Linux MPRIS（尚未充分测试） - 可配置的 HUD 背景主题色混合透明度 - 高级音量控制（混合和热键控制） - Reactive Music 兼容

改进

- 对 24/32 位音频使用 TPDF 重采样 - 1.21.1 上的音频质量 - 歌词动画 - 重构 1.21.1 的渲染管线 - 现代字符串分割器回退 - HUD 流体背景噪声缩放 - 扩大配置中位置偏移可配置的范围 - 调整专辑封面缩略图大小，避免在主界面中出现锯齿 - "音乐收藏详情"和"艺术家详情"界面的返回按钮使用图标

修复

- 1.21.9 ~ 1.21.11 上 Modern UI 3.12.0（mVUS fork） 中 Toast 取消异常 - 文本渲染器在某些情况下裁剪错误

服务端

修复

- Paper 打包中 "api-version" 导致版本兼容判断错误

Client

Feature

- Windows SMTC & Linux MPRIS (have not fully test yet) support - Advanced sound volume control (mix and hotkeys) - Configurable mix alpha for HUD background themed colors - Reactive Music compatibility

Improve

- Using TPDF resample on 24/32 bits audio - Audio quality on 1.21.1 - Lyric animations - Refactors render pipelines on 1.21.1 - Modern string splitter fallback - Hud fluid background noise scaling - Expands position offsets range in config - Changes album image thumbnail size to avoid aliasing in main GUI - Using icons on "back" button in "music collection detail view" and "artist detail view"

Fix

- A toast canceling issue occurred in Modern UI 3.12.0 for 1.21.9 ~ 1.21.11 (mVUS fork) - Text renderer clip wrongly in some situations

Server

Fix

- Some game version wrongly marked as incompatible due to Paper "api-version" ---

客户端

功能

- 支持 Windows SMTC 与 Linux MPRIS（尚未充分测试） - 可配置的 HUD 背景主题色混合透明度 - 高级音量控制（混合和热键控制） - Reactive Music 兼容

改进

- 对 24/32 位音频使用 TPDF 重采样 - 1.21.1 上的音频质量 - 歌词动画 - 重构 1.21.1 的渲染管线 - 现代字符串分割器回退 - HUD 流体背景噪声缩放 - 扩大配置中位置偏移可配置的范围 - 调整专辑封面缩略图大小，避免在主界面中出现锯齿 - "音乐收藏详情"和"艺术家详情"界面的返回按钮使用图标

修复

- 1.21.9 ~ 1.21.11 上 Modern UI 3.12.0（mVUS fork） 中 Toast 取消异常 - 文本渲染器在某些情况下裁剪错误

服务端

修复

- Paper 打包中 "api-version" 导致版本兼容判断错误

Client

Feature

- Windows SMTC & Linux MPRIS (have not fully test yet) support - Advanced sound volume control (mix and hotkeys) - Configurable mix alpha for HUD background themed colors - Reactive Music compatibility

Improve

- Using TPDF resample on 24/32 bits audio - Audio quality on 1.21.1 - Lyric animations - Refactors render pipelines on 1.21.1 - Modern string splitter fallback - Hud fluid background noise scaling - Expands position offsets range in config - Changes album image thumbnail size to avoid aliasing in main GUI - Using icons on "back" button in "music collection detail view" and "artist detail view"

Fix

- A toast canceling issue occurred in Modern UI 3.12.0 for 1.21.9 ~ 1.21.11 (mVUS fork) - Text renderer clip wrongly in some situations

Server

Fix

- Some game version wrongly marked as incompatible due to Paper "api-version" ---

客户端

功能

- 支持 Windows SMTC 与 Linux MPRIS（尚未充分测试） - 可配置的 HUD 背景主题色混合透明度 - 高级音量控制（混合和热键控制） - Reactive Music 兼容

改进

- 对 24/32 位音频使用 TPDF 重采样 - 1.21.1 上的音频质量 - 歌词动画 - 重构 1.21.1 的渲染管线 - 现代字符串分割器回退 - HUD 流体背景噪声缩放 - 扩大配置中位置偏移可配置的范围 - 调整专辑封面缩略图大小，避免在主界面中出现锯齿 - "音乐收藏详情"和"艺术家详情"界面的返回按钮使用图标

修复

- 1.21.9 ~ 1.21.11 上 Modern UI 3.12.0（mVUS fork） 中 Toast 取消异常 - 文本渲染器在某些情况下裁剪错误

服务端

修复

- Paper 打包中 "api-version" 导致版本兼容判断错误

Client

Feature

- Windows SMTC & Linux MPRIS (have not fully test yet) support - Advanced sound volume control (mix and hotkeys) - Configurable mix alpha for HUD background themed colors - Reactive Music compatibility

Improve

- Using TPDF resample on 24/32 bits audio - Audio quality on 1.21.1 - Lyric animations - Refactors render pipelines on 1.21.1 - Modern string splitter fallback - Hud fluid background noise scaling - Expands position offsets range in config - Changes album image thumbnail size to avoid aliasing in main GUI - Using icons on "back" button in "music collection detail view" and "artist detail view"

Fix

- A toast canceling issue occurred in Modern UI 3.12.0 for 1.21.9 ~ 1.21.11 (mVUS fork) - Text renderer clip wrongly in some situations

Server

Fix

- Some game version wrongly marked as incompatible due to Paper "api-version" ---

客户端

功能

- 支持 Windows SMTC 与 Linux MPRIS（尚未充分测试） - 可配置的 HUD 背景主题色混合透明度 - 高级音量控制（混合和热键控制） - Reactive Music 兼容

改进

- 对 24/32 位音频使用 TPDF 重采样 - 1.21.1 上的音频质量 - 歌词动画 - 重构 1.21.1 的渲染管线 - 现代字符串分割器回退 - HUD 流体背景噪声缩放 - 扩大配置中位置偏移可配置的范围 - 调整专辑封面缩略图大小，避免在主界面中出现锯齿 - "音乐收藏详情"和"艺术家详情"界面的返回按钮使用图标

修复

- 1.21.9 ~ 1.21.11 上 Modern UI 3.12.0（mVUS fork） 中 Toast 取消异常 - 文本渲染器在某些情况下裁剪错误

服务端

修复

- Paper 打包中 "api-version" 导致版本兼容判断错误

Client

Feature

- Windows SMTC & Linux MPRIS (have not fully test yet) support - Advanced sound volume control (mix and hotkeys) - Configurable mix alpha for HUD background themed colors - Reactive Music compatibility

Improve

- Using TPDF resample on 24/32 bits audio - Audio quality on 1.21.1 - Lyric animations - Refactors render pipelines on 1.21.1 - Modern string splitter fallback - Hud fluid background noise scaling - Expands position offsets range in config - Changes album image thumbnail size to avoid aliasing in main GUI - Using icons on "back" button in "music collection detail view" and "artist detail view"

Fix

- A toast canceling issue occurred in Modern UI 3.12.0 for 1.21.9 ~ 1.21.11 (mVUS fork) - Text renderer clip wrongly in some situations

Server

Fix

- Some game version wrongly marked as incompatible due to Paper "api-version" ---

客户端

功能

- 支持 Windows SMTC 与 Linux MPRIS（尚未充分测试） - 可配置的 HUD 背景主题色混合透明度 - 高级音量控制（混合和热键控制） - Reactive Music 兼容

改进

- 对 24/32 位音频使用 TPDF 重采样 - 1.21.1 上的音频质量 - 歌词动画 - 重构 1.21.1 的渲染管线 - 现代字符串分割器回退 - HUD 流体背景噪声缩放 - 扩大配置中位置偏移可配置的范围 - 调整专辑封面缩略图大小，避免在主界面中出现锯齿 - "音乐收藏详情"和"艺术家详情"界面的返回按钮使用图标

修复

- 1.21.9 ~ 1.21.11 上 Modern UI 3.12.0（mVUS fork） 中 Toast 取消异常 - 文本渲染器在某些情况下裁剪错误

服务端

修复

- Paper 打包中 "api-version" 导致版本兼容判断错误

Another Hotfix Version :(

Client

Fix

- A ModernUI issue (exists in 3.12, appears on 3.13) causes some lyric lines break and warp at middle - Neoforge edition crashes since 1.2.9

Improve

- HUD background color mix alpha

Server

Fix

- Plugin edition failed to launch since refactor in 1.2.9 ---

我又写炸了（

客户端

修复

- 一个导致了部分歌词行在中部提前换行的 ModernUI 问题（在 3.12 中存在，但在 3.13 中显现） - Neoforge 版在 1.2.9 以来的游戏版本中崩溃

改进

- HUD 背景色混合透明度

服务端

修复

- 自 1.2.9 以来的插件版无法启动问题

Another Hotfix Version :(

Client

Fix

- A ModernUI issue (exists in 3.12, appears on 3.13) causes some lyric lines break and warp at middle - Neoforge edition crashes since 1.2.9

Improve

- HUD background color mix alpha

Server

Fix

- Plugin edition failed to launch since refactor in 1.2.9 ---

我又写炸了（

客户端

修复

- 一个导致了部分歌词行在中部提前换行的 ModernUI 问题（在 3.12 中存在，但在 3.13 中显现） - Neoforge 版在 1.2.9 以来的游戏版本中崩溃

改进

- HUD 背景色混合透明度

服务端

修复

- 自 1.2.9 以来的插件版无法启动问题

Another Hotfix Version :(

Client

Fix

- A ModernUI issue (exists in 3.12, appears on 3.13) causes some lyric lines break and warp at middle - Neoforge edition crashes since 1.2.9

Improve

- HUD background color mix alpha

Server

Fix

- Plugin edition failed to launch since refactor in 1.2.9 ---

我又写炸了（

客户端

修复

- 一个导致了部分歌词行在中部提前换行的 ModernUI 问题（在 3.12 中存在，但在 3.13 中显现） - Neoforge 版在 1.2.9 以来的游戏版本中崩溃

改进

- HUD 背景色混合透明度

服务端

修复

- 自 1.2.9 以来的插件版无法启动问题

Another Hotfix Version :(

Client

Fix

- A ModernUI issue (exists in 3.12, appears on 3.13) causes some lyric lines break and warp at middle - Neoforge edition crashes since 1.2.9

Improve

- HUD background color mix alpha

Server

Fix

- Plugin edition failed to launch since refactor in 1.2.9 ---

我又写炸了（

客户端

修复

- 一个导致了部分歌词行在中部提前换行的 ModernUI 问题（在 3.12 中存在，但在 3.13 中显现） - Neoforge 版在 1.2.9 以来的游戏版本中崩溃

改进

- HUD 背景色混合透明度

服务端

修复

- 自 1.2.9 以来的插件版无法启动问题

Another Hotfix Version :(

Client

Fix

- A ModernUI issue (exists in 3.12, appears on 3.13) causes some lyric lines break and warp at middle - Neoforge edition crashes since 1.2.9

Improve

- HUD background color mix alpha

Server

Fix

- Plugin edition failed to launch since refactor in 1.2.9 ---

我又写炸了（

客户端

修复

- 一个导致了部分歌词行在中部提前换行的 ModernUI 问题（在 3.12 中存在，但在 3.13 中显现） - Neoforge 版在 1.2.9 以来的游戏版本中崩溃

改进

- HUD 背景色混合透明度

服务端

修复

- 自 1.2.9 以来的插件版无法启动问题

Client

Dependencies

- For 1.21.1, 1.21.6-8, 26.1.x , now ModernUI 3.13.0 is required

Feature

- "Main screen additional background darken rate" option in config view - Check API service version in config view - Marquee animation for overflow texts in HUD, switchable in config view

Improve

- Improved HUD fluid background - Improved HUD theme color extract - Reordered options of integrated server category in config view - Eliminated pause when routing between grouped server's sub-server - Slightly improved shader performance

Fix

- Several visual issues in home view when switching music - Unable to view own private list

Server

Fix

- Unable to view own private list ---

客户端

依赖

- 对于 1.21.1, 1.21.6-8, 26.1.x，需要 ModernUI 3.13.0

功能

- "主界面额外暗化比例" 选项 - 在设置中可检查 API 服务版本 - HUD 中过长文本的走马灯动画，可在设置中开关

改进

- HUD 流体背景 - HUD 主题色取色 - 重排了设置中集成服务器类别的选项 - 消除了在群组服的子服间切换时的音频暂停 - 略微改进了着色器性能

修复

- 主页切换音乐时的一些视觉问题 - 无法查看自己的隐私歌单

服务端

修复

- 无法查看自己的隐私歌单

Client

Dependencies

- For 1.21.1, 1.21.6-8, 26.1.x , now ModernUI 3.13.0 is required

Feature

- "Main screen additional background darken rate" option in config view - Check API service version in config view - Marquee animation for overflow texts in HUD, switchable in config view

Improve

- Improved HUD fluid background - Improved HUD theme color extract - Reordered options of integrated server category in config view - Eliminated pause when routing between grouped server's sub-server - Slightly improved shader performance

Fix

- Several visual issues in home view when switching music - Unable to view own private list

Server

Fix

- Unable to view own private list ---

客户端

依赖

- 对于 1.21.1, 1.21.6-8, 26.1.x，需要 ModernUI 3.13.0

功能

- "主界面额外暗化比例" 选项 - 在设置中可检查 API 服务版本 - HUD 中过长文本的走马灯动画，可在设置中开关

改进

- HUD 流体背景 - HUD 主题色取色 - 重排了设置中集成服务器类别的选项 - 消除了在群组服的子服间切换时的音频暂停 - 略微改进了着色器性能

修复

- 主页切换音乐时的一些视觉问题 - 无法查看自己的隐私歌单

服务端

修复

- 无法查看自己的隐私歌单

Client

Dependencies

- For 1.21.1, 1.21.6-8, 26.1.x , now ModernUI 3.13.0 is required

Feature

- "Main screen additional background darken rate" option in config view - Check API service version in config view - Marquee animation for overflow texts in HUD, switchable in config view

Improve

- Improved HUD fluid background - Improved HUD theme color extract - Reordered options of integrated server category in config view - Eliminated pause when routing between grouped server's sub-server - Slightly improved shader performance

Fix

- Several visual issues in home view when switching music - Unable to view own private list

Server

Fix

- Unable to view own private list ---

客户端

依赖

- 对于 1.21.1, 1.21.6-8, 26.1.x，需要 ModernUI 3.13.0

功能

- "主界面额外暗化比例" 选项 - 在设置中可检查 API 服务版本 - HUD 中过长文本的走马灯动画，可在设置中开关

改进

- HUD 流体背景 - HUD 主题色取色 - 重排了设置中集成服务器类别的选项 - 消除了在群组服的子服间切换时的音频暂停 - 略微改进了着色器性能

修复

- 主页切换音乐时的一些视觉问题 - 无法查看自己的隐私歌单

服务端

修复

- 无法查看自己的隐私歌单

Client

Dependencies

- For 1.21.1, 1.21.6-8, 26.1.x , now ModernUI 3.13.0 is required

Feature

- "Main screen additional background darken rate" option in config view - Check API service version in config view - Marquee animation for overflow texts in HUD, switchable in config view

Improve

- Improved HUD fluid background - Improved HUD theme color extract - Reordered options of integrated server category in config view - Eliminated pause when routing between grouped server's sub-server - Slightly improved shader performance

Fix

- Several visual issues in home view when switching music - Unable to view own private list

Server

Fix

- Unable to view own private list ---

客户端

依赖

- 对于 1.21.1, 1.21.6-8, 26.1.x，需要 ModernUI 3.13.0

功能

- "主界面额外暗化比例" 选项 - 在设置中可检查 API 服务版本 - HUD 中过长文本的走马灯动画，可在设置中开关

改进

- HUD 流体背景 - HUD 主题色取色 - 重排了设置中集成服务器类别的选项 - 消除了在群组服的子服间切换时的音频暂停 - 略微改进了着色器性能

修复

- 主页切换音乐时的一些视觉问题 - 无法查看自己的隐私歌单

服务端

修复

- 无法查看自己的隐私歌单

Client

Dependencies

- For 1.21.1, 1.21.6-8, 26.1.x , now ModernUI 3.13.0 is required

Feature

- "Main screen additional background darken rate" option in config view - Check API service version in config view - Marquee animation for overflow texts in HUD, switchable in config view

Improve

- Improved HUD fluid background - Improved HUD theme color extract - Reordered options of integrated server category in config view - Eliminated pause when routing between grouped server's sub-server - Slightly improved shader performance

Fix

- Several visual issues in home view when switching music - Unable to view own private list

Server

Fix

- Unable to view own private list ---

客户端

依赖

- 对于 1.21.1, 1.21.6-8, 26.1.x，需要 ModernUI 3.13.0

功能

- "主界面额外暗化比例" 选项 - 在设置中可检查 API 服务版本 - HUD 中过长文本的走马灯动画，可在设置中开关

改进

- HUD 流体背景 - HUD 主题色取色 - 重排了设置中集成服务器类别的选项 - 消除了在群组服的子服间切换时的音频暂停 - 略微改进了着色器性能

修复

- 主页切换音乐时的一些视觉问题 - 无法查看自己的隐私歌单

服务端

修复

- 无法查看自己的隐私歌单

This is mainly a client fix version, but include several server refactor

Fix

- Toast notification i18n missing when trying to switch connection in integrated server - Duplicate PlayerLoginInfo in isolated mode integrated serverside's LoginApiService.playerInfoMap caused by some situations like level change, which may causes discorrect error notification on hud - Manually connecting to a server with no serverside support causes idle lock - Player's head disappears while switched to single player world or isolated mode during the first track playing

Improve

- Playing status on HUD updating situations ---

该版本主要修复客户端问题，但包含了部分服务端重构

修复

- 试图在集成服务器中切换连接时 Toast 通知的国际化缺失 - 集成服务端中 LoginApiService.playerInfoMap 中的玩家登录信息在切换维度等情景下重复，可能导致 HUD 上不准确的错误提示 - 手动连接到无服务端支持的服务器时被锁定在无音乐播放状态 - 玩家头像在切换到集成服务端时播放第一首音乐时消失

改进

- HUD 上的连接状态更新情景

This is mainly a client fix version, but include several server refactor

Fix

- Toast notification i18n missing when trying to switch connection in integrated server - Duplicate PlayerLoginInfo in isolated mode integrated serverside's LoginApiService.playerInfoMap caused by some situations like level change, which may causes discorrect error notification on hud - Manually connecting to a server with no serverside support causes idle lock - Player's head disappears while switched to single player world or isolated mode during the first track playing

Improve

- Playing status on HUD updating situations ---

该版本主要修复客户端问题，但包含了部分服务端重构

修复

- 试图在集成服务器中切换连接时 Toast 通知的国际化缺失 - 集成服务端中 LoginApiService.playerInfoMap 中的玩家登录信息在切换维度等情景下重复，可能导致 HUD 上不准确的错误提示 - 手动连接到无服务端支持的服务器时被锁定在无音乐播放状态 - 玩家头像在切换到集成服务端时播放第一首音乐时消失

改进

- HUD 上的连接状态更新情景

This is mainly a client fix version, but include several server refactor

Fix

- Toast notification i18n missing when trying to switch connection in integrated server - Duplicate PlayerLoginInfo in isolated mode integrated serverside's LoginApiService.playerInfoMap caused by some situations like level change, which may causes discorrect error notification on hud - Manually connecting to a server with no serverside support causes idle lock - Player's head disappears while switched to single player world or isolated mode during the first track playing

Improve

- Playing status on HUD updating situations ---

该版本主要修复客户端问题，但包含了部分服务端重构

修复

- 试图在集成服务器中切换连接时 Toast 通知的国际化缺失 - 集成服务端中 LoginApiService.playerInfoMap 中的玩家登录信息在切换维度等情景下重复，可能导致 HUD 上不准确的错误提示 - 手动连接到无服务端支持的服务器时被锁定在无音乐播放状态 - 玩家头像在切换到集成服务端时播放第一首音乐时消失

改进

- HUD 上的连接状态更新情景

This is mainly a client fix version, but include several server refactor

Fix

- Toast notification i18n missing when trying to switch connection in integrated server - Duplicate PlayerLoginInfo in isolated mode integrated serverside's LoginApiService.playerInfoMap caused by some situations like level change, which may causes discorrect error notification on hud - Manually connecting to a server with no serverside support causes idle lock - Player's head disappears while switched to single player world or isolated mode during the first track playing

Improve

- Playing status on HUD updating situations ---

该版本主要修复客户端问题，但包含了部分服务端重构

修复

- 试图在集成服务器中切换连接时 Toast 通知的国际化缺失 - 集成服务端中 LoginApiService.playerInfoMap 中的玩家登录信息在切换维度等情景下重复，可能导致 HUD 上不准确的错误提示 - 手动连接到无服务端支持的服务器时被锁定在无音乐播放状态 - 玩家头像在切换到集成服务端时播放第一首音乐时消失

改进

- HUD 上的连接状态更新情景

This is mainly a client fix version, but include several server refactor

Fix

- Toast notification i18n missing when trying to switch connection in integrated server - Duplicate PlayerLoginInfo in isolated mode integrated serverside's LoginApiService.playerInfoMap caused by some situations like level change, which may causes discorrect error notification on hud - Manually connecting to a server with no serverside support causes idle lock - Player's head disappears while switched to single player world or isolated mode during the first track playing

Improve

- Playing status on HUD updating situations ---

该版本主要修复客户端问题，但包含了部分服务端重构

修复

- 试图在集成服务器中切换连接时 Toast 通知的国际化缺失 - 集成服务端中 LoginApiService.playerInfoMap 中的玩家登录信息在切换维度等情景下重复，可能导致 HUD 上不准确的错误提示 - 手动连接到无服务端支持的服务器时被锁定在无音乐播放状态 - 玩家头像在切换到集成服务端时播放第一首音乐时消失

改进

- HUD 上的连接状态更新情景

Client

Feature

- Auto connecting serverside controls (enable/disable, blacklist/whitelist) - Isolated Mode: allows Music HUD to work only in client when join into a no serverside support / incompatible serverside / serverside disconnected server - "Connected"/"Disconnected" icons on hud status indicator

Fix

- ApiServerManager jvm shutdown hook duplicate registration

Improve

- Slightly improved render performance on 1.21.1 - Refine services' status management

Server

Fix

- ApiServerManager shutdown hook deploying

Improve

- Refine services' status management ---

客户端

功能

- 自动连接服务器相关控制（开/关，黑名单/白名单） - 隔离模式：允许 Music HUD 在加入无服务端支持/服务端侧版本不兼容/从服务端断开的服务器时以仅客户端模式运行 - HUD 状态指示器“已连接”/“未连接”

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

改进

- 在 1.21.11 上略微改进性能 - 优化服务状态管理

服务端

改进

- 优化服务状态管理 -

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

Client

Feature

- Auto connecting serverside controls (enable/disable, blacklist/whitelist) - Isolated Mode: allows Music HUD to work only in client when join into a no serverside support / incompatible serverside / serverside disconnected server - "Connected"/"Disconnected" icons on hud status indicator

Fix

- ApiServerManager jvm shutdown hook duplicate registration

Improve

- Slightly improved render performance on 1.21.1 - Refine services' status management

Server

Fix

- ApiServerManager shutdown hook deploying

Improve

- Refine services' status management ---

客户端

功能

- 自动连接服务器相关控制（开/关，黑名单/白名单） - 隔离模式：允许 Music HUD 在加入无服务端支持/服务端侧版本不兼容/从服务端断开的服务器时以仅客户端模式运行 - HUD 状态指示器“已连接”/“未连接”

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

改进

- 在 1.21.11 上略微改进性能 - 优化服务状态管理

服务端

改进

- 优化服务状态管理 -

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

Client

Feature

- Auto connecting serverside controls (enable/disable, blacklist/whitelist) - Isolated Mode: allows Music HUD to work only in client when join into a no serverside support / incompatible serverside / serverside disconnected server - "Connected"/"Disconnected" icons on hud status indicator

Fix

- ApiServerManager jvm shutdown hook duplicate registration

Improve

- Slightly improved render performance on 1.21.1 - Refine services' status management

Server

Fix

- ApiServerManager shutdown hook deploying

Improve

- Refine services' status management ---

客户端

功能

- 自动连接服务器相关控制（开/关，黑名单/白名单） - 隔离模式：允许 Music HUD 在加入无服务端支持/服务端侧版本不兼容/从服务端断开的服务器时以仅客户端模式运行 - HUD 状态指示器“已连接”/“未连接”

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

改进

- 在 1.21.11 上略微改进性能 - 优化服务状态管理

服务端

改进

- 优化服务状态管理 -

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

Client

Feature

- Auto connecting serverside controls (enable/disable, blacklist/whitelist) - Isolated Mode: allows Music HUD to work only in client when join into a no serverside support / incompatible serverside / serverside disconnected server - "Connected"/"Disconnected" icons on hud status indicator

Fix

- ApiServerManager jvm shutdown hook duplicate registration

Improve

- Slightly improved render performance on 1.21.1 - Refine services' status management

Server

Fix

- ApiServerManager shutdown hook deploying

Improve

- Refine services' status management ---

客户端

功能

- 自动连接服务器相关控制（开/关，黑名单/白名单） - 隔离模式：允许 Music HUD 在加入无服务端支持/服务端侧版本不兼容/从服务端断开的服务器时以仅客户端模式运行 - HUD 状态指示器“已连接”/“未连接”

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

改进

- 在 1.21.11 上略微改进性能 - 优化服务状态管理

服务端

改进

- 优化服务状态管理 -

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

Client

Feature

- Auto connecting serverside controls (enable/disable, blacklist/whitelist) - Isolated Mode: allows Music HUD to work only in client when join into a no serverside support / incompatible serverside / serverside disconnected server - "Connected"/"Disconnected" icons on hud status indicator

Fix

- ApiServerManager jvm shutdown hook duplicate registration

Improve

- Slightly improved render performance on 1.21.1 - Refine services' status management

Server

Fix

- ApiServerManager shutdown hook deploying

Improve

- Refine services' status management ---

客户端

功能

- 自动连接服务器相关控制（开/关，黑名单/白名单） - 隔离模式：允许 Music HUD 在加入无服务端支持/服务端侧版本不兼容/从服务端断开的服务器时以仅客户端模式运行 - HUD 状态指示器“已连接”/“未连接”

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

改进

- 在 1.21.11 上略微改进性能 - 优化服务状态管理

服务端

改进

- 优化服务状态管理 -

修复

- API 服务器管理中 jvm 关闭钩子的重复注册

Platform

Experimentally supports 26.1.x ModernUI 26.1 fork: https://github.com/Chino081/ModernUI-MC-mVUS Feel free to submit issues if you encountered any problems ---

平台

实验性适配 26.1.x ModernUI 26.1 分支：https://github.com/Chino081/ModernUI-MC-mVUS 遇到任何问题，可提交议题

Platform

Experimentally supports 1.21.1 (with all functions, in alpha, finally...)

Potential Issues

Feel free to submit issues on GitHub

- Bad performance - Bad compatibility with other mods modified render pipelines - Bad stability

Client

Fix

- Illegal status bugs caused by bad event handling - Logging out turns connecting mode to not_connected - Crash caused by LoginView's internal invalid status

Improve

- Using explicit color space (SRGB) on image processing

Server

Fix

- API server manager wrongly calls client side codes - Illegal status bug caused by bad event handling ---

平台

对 1.21.1 的实验性支持（拥有全部功能，alpha 阶段，终于...）

潜在问题

如遇到问题请在 GitHub 上提交议题

- 低性能 - 与其他修改渲染管线的模组的兼容性 - 低稳定性

客户端

修复

- 事件处理状态问题导致的 Bugs - 登出账户时会被错误地切换到未连接状态 - 登录页中的状态管理出错导致的崩溃

改进

- 显式地在图片处理中使用颜色空间（SRGB）

服务端

修复

- API 管理错误地调用了客户端代码 - 事件处理状态问题导致的 Bugs

Platform

Experimentally supports 1.21.1 (with all functions, in alpha, finally...)

Potential Issues

Feel free to submit issues on GitHub

- Bad performance - Bad compatibility with other mods modified render pipelines - Bad stability

Client

Fix

- Illegal status bugs caused by bad event handling - Logging out turns connecting mode to not_connected - Crash caused by LoginView's internal invalid status

Improve

- Using explicit color space (SRGB) on image processing

Server

Fix

- API server manager wrongly calls client side codes - Illegal status bug caused by bad event handling ---

平台

对 1.21.1 的实验性支持（拥有全部功能，alpha 阶段，终于...）

潜在问题

如遇到问题请在 GitHub 上提交议题

- 低性能 - 与其他修改渲染管线的模组的兼容性 - 低稳定性

客户端

修复

- 事件处理状态问题导致的 Bugs - 登出账户时会被错误地切换到未连接状态 - 登录页中的状态管理出错导致的崩溃

改进

- 显式地在图片处理中使用颜色空间（SRGB）

服务端

修复

- API 管理错误地调用了客户端代码 - 事件处理状态问题导致的 Bugs

Platform

Experimentally supports 1.21.1 (with all functions, in alpha, finally...)

Potential Issues

Feel free to submit issues on GitHub

- Bad performance - Bad compatibility with other mods modified render pipelines - Bad stability

Client

Fix

- Illegal status bugs caused by bad event handling - Logging out turns connecting mode to not_connected - Crash caused by LoginView's internal invalid status

Improve

- Using explicit color space (SRGB) on image processing

Server

Fix

- API server manager wrongly calls client side codes - Illegal status bug caused by bad event handling ---

平台

对 1.21.1 的实验性支持（拥有全部功能，alpha 阶段，终于...）

潜在问题

如遇到问题请在 GitHub 上提交议题

- 低性能 - 与其他修改渲染管线的模组的兼容性 - 低稳定性

客户端

修复

- 事件处理状态问题导致的 Bugs - 登出账户时会被错误地切换到未连接状态 - 登录页中的状态管理出错导致的崩溃

改进

- 显式地在图片处理中使用颜色空间（SRGB）

服务端

修复

- API 管理错误地调用了客户端代码 - 事件处理状态问题导致的 Bugs

Platform

Experimentally supports 1.21.1 (with all functions, in alpha, finally...)

Potential Issues

Feel free to submit issues on GitHub

- Bad performance - Bad compatibility with other mods modified render pipelines - Bad stability

Client

Fix

- Illegal status bugs caused by bad event handling - Logging out turns connecting mode to not_connected - Crash caused by LoginView's internal invalid status

Improve

- Using explicit color space (SRGB) on image processing

Server

Fix

- API server manager wrongly calls client side codes - Illegal status bug caused by bad event handling ---

平台

对 1.21.1 的实验性支持（拥有全部功能，alpha 阶段，终于...）

潜在问题

如遇到问题请在 GitHub 上提交议题

- 低性能 - 与其他修改渲染管线的模组的兼容性 - 低稳定性

客户端

修复

- 事件处理状态问题导致的 Bugs - 登出账户时会被错误地切换到未连接状态 - 登录页中的状态管理出错导致的崩溃

改进

- 显式地在图片处理中使用颜色空间（SRGB）

服务端

修复

- API 管理错误地调用了客户端代码 - 事件处理状态问题导致的 Bugs

Client

Feature

- Fading edge of Staggered Lyric Scroll View

Improve

- "ShowTranslatedCnLyrics" are hot-updatable now - Replaced old stagger scrolling animation with Apple-style Spring Animation - Some details about Staggered Lyric Scroll View and word-by-word lyric highlight animation

Remove

- Removed additional dark background in GUI ( due to the need to use BlendMode.DST_OUT to implements Fading edge effect, and it will mess up the background), now the main gui will completely follow the preference in ModernUI Action Center

Server

Improve

- API Server's lifecycle management ( launch and shutdown hook ) ---

客户端

功能

- 歌词滚动视图边缘淡化

改进

- “显示中文歌词翻译”选项现在可热更新 - 用 Apple 风格的弹簧动画替换了旧的歌词交错滚动动画 - 歌词滚动视图及逐字高亮动画的各类细节 - 流体背景取色方式

修复

- 许多可能存在的资源泄漏以及不安全写法

移除

- 移除了主界面的额外暗色背景（由于需要使用 BlendMode.DST_OUT 实现边缘淡化效果而冲突），现在主界面会完全跟随 ModernUI 操作中心里的偏好

服务端

改进

- API 服务器的生命周期管理（启动、关闭钩子）

Client

Feature

- Fading edge of Staggered Lyric Scroll View

Improve

- "ShowTranslatedCnLyrics" are hot-updatable now - Replaced old stagger scrolling animation with Apple-style Spring Animation - Some details about Staggered Lyric Scroll View and word-by-word lyric highlight animation

Remove

- Removed additional dark background in GUI ( due to the need to use BlendMode.DST_OUT to implements Fading edge effect, and it will mess up the background), now the main gui will completely follow the preference in ModernUI Action Center

Server

Improve

- API Server's lifecycle management ( launch and shutdown hook ) ---

客户端

功能

- 歌词滚动视图边缘淡化

改进

- “显示中文歌词翻译”选项现在可热更新 - 用 Apple 风格的弹簧动画替换了旧的歌词交错滚动动画 - 歌词滚动视图及逐字高亮动画的各类细节 - 流体背景取色方式

修复

- 许多可能存在的资源泄漏以及不安全写法

移除

- 移除了主界面的额外暗色背景（由于需要使用 BlendMode.DST_OUT 实现边缘淡化效果而冲突），现在主界面会完全跟随 ModernUI 操作中心里的偏好

服务端

改进

- API 服务器的生命周期管理（启动、关闭钩子）

Client

Feature

- Fading edge of Staggered Lyric Scroll View

Improve

- "ShowTranslatedCnLyrics" are hot-updatable now - Replaced old stagger scrolling animation with Apple-style Spring Animation - Some details about Staggered Lyric Scroll View and word-by-word lyric highlight animation

Remove

- Removed additional dark background in GUI ( due to the need to use BlendMode.DST_OUT to implements Fading edge effect, and it will mess up the background), now the main gui will completely follow the preference in ModernUI Action Center

Server

Improve

- API Server's lifecycle management ( launch and shutdown hook ) ---

客户端

功能

- 歌词滚动视图边缘淡化

改进

- “显示中文歌词翻译”选项现在可热更新 - 用 Apple 风格的弹簧动画替换了旧的歌词交错滚动动画 - 歌词滚动视图及逐字高亮动画的各类细节 - 流体背景取色方式

修复

- 许多可能存在的资源泄漏以及不安全写法

移除

- 移除了主界面的额外暗色背景（由于需要使用 BlendMode.DST_OUT 实现边缘淡化效果而冲突），现在主界面会完全跟随 ModernUI 操作中心里的偏好

服务端

改进

- API 服务器的生命周期管理（启动、关闭钩子）

Fix

- 1.2.4 plugin packaging ---

修复

- 1.2.4 插件版打包问题

Fix

- 1.2.4 plugin packaging ---

修复

- 1.2.4 插件版打包问题

Fix

- 1.2.4 plugin packaging ---

修复

- 1.2.4 插件版打包问题

Improve

#### Client - More natural staggered lyric scrolling behavior - Smoother lyric rhythm line animation - Lyric highlight gradient - Lyric parsing, invalid character removing - Stream audio player playing progress sync precision

Fix

#### Common - Wrongly mark 1.2.2 as incompatible in 1.2.3 (Stupid mistake again :( ) #### Client - Audio mismatches with lyric when buffering in some cases #### Server - Cookie processed incorrectly, may cause api failure and audio quality downgrade ---

改进

#### 客户端 - 更自然的歌词交错滚动逻辑 - 更流畅的间奏呼吸提示 - 歌词高亮渐变 - 在歌词解析中移除无效字符 - 播放器播放进度同步的准确性

修复

#### 通用 - 在 1.2.3 中错误地将最低兼容版本标记为 1.2.3 导致错误地判断了与 1.2.2 不兼容 #### 客户端 - 在部分情况下缓冲完成后音频不同步 #### 服务端 - Cookie 被错误处理，可能导致 API 调用失败和音频质量降级

Improve

#### Client - More natural staggered lyric scrolling behavior - Smoother lyric rhythm line animation - Lyric highlight gradient - Lyric parsing, invalid character removing - Stream audio player playing progress sync precision

Fix

#### Common - Wrongly mark 1.2.2 as incompatible in 1.2.3 (Stupid mistake again :( ) #### Client - Audio mismatches with lyric when buffering in some cases #### Server - Cookie processed incorrectly, may cause api failure and audio quality downgrade ---

改进

#### 客户端 - 更自然的歌词交错滚动逻辑 - 更流畅的间奏呼吸提示 - 歌词高亮渐变 - 在歌词解析中移除无效字符 - 播放器播放进度同步的准确性

修复

#### 通用 - 在 1.2.3 中错误地将最低兼容版本标记为 1.2.3 导致错误地判断了与 1.2.2 不兼容 #### 客户端 - 在部分情况下缓冲完成后音频不同步 #### 服务端 - Cookie 被错误处理，可能导致 API 调用失败和音频质量降级

Improve

#### Client - More natural staggered lyric scrolling behavior - Smoother lyric rhythm line animation - Lyric highlight gradient - Lyric parsing, invalid character removing - Stream audio player playing progress sync precision

Fix

#### Common - Wrongly mark 1.2.2 as incompatible in 1.2.3 (Stupid mistake again :( ) #### Client - Audio mismatches with lyric when buffering in some cases #### Server - Cookie processed incorrectly, may cause api failure and audio quality downgrade ---

改进

#### 客户端 - 更自然的歌词交错滚动逻辑 - 更流畅的间奏呼吸提示 - 歌词高亮渐变 - 在歌词解析中移除无效字符 - 播放器播放进度同步的准确性

修复

#### 通用 - 在 1.2.3 中错误地将最低兼容版本标记为 1.2.3 导致错误地判断了与 1.2.2 不兼容 #### 客户端 - 在部分情况下缓冲完成后音频不同步 #### 服务端 - Cookie 被错误处理，可能导致 API 调用失败和音频质量降级

Feature

- HUD word-by-word lyric highlighting

Fix

- HUD theme colors mixed wrongly when transitioning - Mismatch between audio and lyric after resource reloaded - NowPlayingInfo currentLyricLine did not clear when switch to next track to play (may have visual discorrect on HomeView)

Improve

- StaggeredLyricScrollView scrolling behavior to avoid jump transition in some cases ---

功能

- HUD 逐字歌词高亮

修复

- HUD 主题色过渡混合错误 - 资源重载后音频与歌词错位 - 切换歌曲时，NowPlayingInfo 的当前歌词行状态未被正确清除（可能造成错误视图）

改进

- 歌词滚动行为，以避免一些情况下的滚动跳变

Feature

- HUD word-by-word lyric highlighting

Fix

- HUD theme colors mixed wrongly when transitioning - Mismatch between audio and lyric after resource reloaded - NowPlayingInfo currentLyricLine did not clear when switch to next track to play (may have visual discorrect on HomeView)

Improve

- StaggeredLyricScrollView scrolling behavior to avoid jump transition in some cases ---

功能

- HUD 逐字歌词高亮

修复

- HUD 主题色过渡混合错误 - 资源重载后音频与歌词错位 - 切换歌曲时，NowPlayingInfo 的当前歌词行状态未被正确清除（可能造成错误视图）

改进

- 歌词滚动行为，以避免一些情况下的滚动跳变

Feature

- HUD word-by-word lyric highlighting

Fix

- HUD theme colors mixed wrongly when transitioning - Mismatch between audio and lyric after resource reloaded - NowPlayingInfo currentLyricLine did not clear when switch to next track to play (may have visual discorrect on HomeView)

Improve

- StaggeredLyricScrollView scrolling behavior to avoid jump transition in some cases ---

功能

- HUD 逐字歌词高亮

修复

- HUD 主题色过渡混合错误 - 资源重载后音频与歌词错位 - 切换歌曲时，NowPlayingInfo 的当前歌词行状态未被正确清除（可能造成错误视图）

改进

- 歌词滚动行为，以避免一些情况下的滚动跳变

Compatibility

1.2.2 or later (due to modify data structure)

Feature

- Home View word-by-word lyrics inspired by Apple Music

Improve

- Hud text colors - Music List Item info line auto warp

Refactor

- Hud render pipelines ---

兼容性

1.2.2 及之后（由于修改数据结构）

功能

- 受 Apple Music 启发的主页逐字歌词

改进

- Hud 文字颜色 - 音乐列表项信息行的自动换行

重构

- Hud 渲染管线

Compatibility

1.2.2 or later (due to modify data structure)

Feature

- Home View word-by-word lyrics inspired by Apple Music

Improve

- Hud text colors - Music List Item info line auto warp

Refactor

- Hud render pipelines ---

兼容性

1.2.2 及之后（由于修改数据结构）

功能

- 受 Apple Music 启发的主页逐字歌词

改进

- Hud 文字颜色 - 音乐列表项信息行的自动换行

重构

- Hud 渲染管线

Compatibility

1.2.2 or later (due to modify data structure)

Feature

- Home View word-by-word lyrics inspired by Apple Music

Improve

- Hud text colors - Music List Item info line auto warp

Refactor

- Hud render pipelines ---

兼容性

1.2.2 及之后（由于修改数据结构）

功能

- 受 Apple Music 启发的主页逐字歌词

改进

- Hud 文字颜色 - 音乐列表项信息行的自动换行

重构

- Hud 渲染管线

Compatibility

1.2.1 or later (due to removing dependency on Architectury API)

Feature

- Hud dynamic liquid background

Improve

- Remove dependency on Architectury API - Add "Logout" button when failed to load user data - Option enableEmbeddedServer are hot-updatable now - "Refresh" button in account view

Fix

- Account view status refresh - NeoForge clients cannot join servers where MusicHUD is not installed - Hud background covers texts / title missing in some situations - MusicCollectionCard "addToIdleSourceButton" status refresh ---

兼容性

1.2.1 及之后（由于移除对 Architectury API 的依赖）

功能

- Hud 流体背景

改进

- 移除对 Architectury API 的依赖 - 在无法加载用户数据错误页添加了登出按钮 - 使 "在 单人 / 局域网联机（主机） 中启用 Music Hud" 选项可热更新 - 账户页中的刷新按钮

修复

- 账户页的登录状态更新失效 - NeoForge 端可能无法加入未安装 MusicHUD 的服务器 - 有时 Hud 背景层级错误而覆盖了文本 - 歌单/专辑卡片 "添加到空闲播放源" 按钮的状态检测错误

Compatibility

1.2.1 or later (due to removing dependency on Architectury API)

Feature

- Hud dynamic liquid background

Improve

- Remove dependency on Architectury API - Add "Logout" button when failed to load user data - Option enableEmbeddedServer are hot-updatable now - "Refresh" button in account view

Fix

- Account view status refresh - NeoForge clients cannot join servers where MusicHUD is not installed - Hud background covers texts / title missing in some situations - MusicCollectionCard "addToIdleSourceButton" status refresh ---

兼容性

1.2.1 及之后（由于移除对 Architectury API 的依赖）

功能

- Hud 流体背景

改进

- 移除对 Architectury API 的依赖 - 在无法加载用户数据错误页添加了登出按钮 - 使 "在 单人 / 局域网联机（主机） 中启用 Music Hud" 选项可热更新 - 账户页中的刷新按钮

修复

- 账户页的登录状态更新失效 - NeoForge 端可能无法加入未安装 MusicHUD 的服务器 - 有时 Hud 背景层级错误而覆盖了文本 - 歌单/专辑卡片 "添加到空闲播放源" 按钮的状态检测错误

Compatibility

1.2.1 or later (due to removing dependency on Architectury API)

Feature

- Hud dynamic liquid background

Improve

- Remove dependency on Architectury API - Add "Logout" button when failed to load user data - Option enableEmbeddedServer are hot-updatable now - "Refresh" button in account view

Fix

- Account view status refresh - NeoForge clients cannot join servers where MusicHUD is not installed - Hud background covers texts / title missing in some situations - MusicCollectionCard "addToIdleSourceButton" status refresh ---

兼容性

1.2.1 及之后（由于移除对 Architectury API 的依赖）

功能

- Hud 流体背景

改进

- 移除对 Architectury API 的依赖 - 在无法加载用户数据错误页添加了登出按钮 - 使 "在 单人 / 局域网联机（主机） 中启用 Music Hud" 选项可热更新 - 账户页中的刷新按钮

修复

- 账户页的登录状态更新失效 - NeoForge 端可能无法加入未安装 MusicHUD 的服务器 - 有时 Hud 背景层级错误而覆盖了文本 - 歌单/专辑卡片 "添加到空闲播放源" 按钮的状态检测错误

Sorry for stupid mistake (wrong builds) :(

Fix

- Unable to search playlists - MusicListItem edge cutted

Improve

- Loggers v-thread names --- 犯傻了，上个版本放了个旧构建（

修复

- 无法搜索歌单 - 曲目列表项边缘被裁切

改进

- 日志虚拟线程名称

Sorry for stupid mistake (wrong builds) :(

Fix

- Unable to search playlists - MusicListItem edge cutted

Improve

- Loggers v-thread names --- 犯傻了，上个版本放了个旧构建（

修复

- 无法搜索歌单 - 曲目列表项边缘被裁切

改进

- 日志虚拟线程名称

Sorry for stupid mistake (wrong builds) :(

Fix

- Unable to search playlists - MusicListItem edge cutted

Improve

- Loggers v-thread names --- 犯傻了，上个版本放了个旧构建（

修复

- 无法搜索歌单 - 曲目列表项边缘被裁切

改进

- 日志虚拟线程名称

Compatibility

1.2.0 prerelease or later

Feature

- Phone validation code login - WAV support - Music from cloud drive support

Fix

- Always using anonymous cookie to fetch resources - Music list items edge cut in certain circumstances ---

兼容性

1.2.0 prerelease 或之后

功能

- 手机验证码登录 - WAV 格式支持 - 对歌单中来自于云盘的歌的支持

修复

- 始终使用游客 Cookie 获取资源的问题 - 音乐列表项在特定情况下内部元素被截断

Compatibility

1.2.0 prerelease or later

Feature

- Phone validation code login - WAV support - Music from cloud drive support

Fix

- Always using anonymous cookie to fetch resources - Music list items edge cut in certain circumstances ---

兼容性

1.2.0 prerelease 或之后

功能

- 手机验证码登录 - WAV 格式支持 - 对歌单中来自于云盘的歌的支持

修复

- 始终使用游客 Cookie 获取资源的问题 - 音乐列表项在特定情况下内部元素被截断

Compatibility

1.2.0 prerelease or later

Feature

- Phone validation code login - WAV support - Music from cloud drive support

Fix

- Always using anonymous cookie to fetch resources - Music list items edge cut in certain circumstances ---

兼容性

1.2.0 prerelease 或之后

功能

- 手机验证码登录 - WAV 格式支持 - 对歌单中来自于云盘的歌的支持

修复

- 始终使用游客 Cookie 获取资源的问题 - 音乐列表项在特定情况下内部元素被截断

Compatibility

1.2.0 beta 1 or later

Platform

- Experimental (Bukkit/)Paper/Purpur/Spigot/Folia support (thanks to [MOPELotus](https://github.com/MOPELotus))

Feature

- My subscribed albums / artists list in account view

Improve

- HUD now uses icons to notify now, instead of texts - Music API Server running detection - Intermediate progress bar when music is loading - Mod description - Left menu in gui now can scroll

Fix

- Music Data Pusher concurrent calling problem

Refactor

- Abstract layer for configs, events, networks and keybinds ---

兼容性

1.2.0 beta 1 或之后

平台

- 对(Bukkit系的) Paper/Purpur/Spigot/Folia 的实验性支持（感谢[MOPELotus](https://github.com/MOPELotus)）

功能

- 账户页中可见我收藏的专辑/歌手

改进

- HUD 中使用图标而不是文本指示状态 - API 服务器可用性检测 - 音乐加载提示 - Mod 描述 - 主界面左侧菜单可滚动

修复

- 服务端推送线程并发问题

重构

- 对配置、事件、网络、按键等服务的抽象层

Compatibility

1.2.0 beta 1 or later

Platform

- Experimental (Bukkit/)Paper/Purpur/Spigot/Folia support (thanks to [MOPELotus](https://github.com/MOPELotus))

Feature

- My subscribed albums / artists list in account view

Improve

- HUD now uses icons to notify now, instead of texts - Music API Server running detection - Intermediate progress bar when music is loading - Mod description - Left menu in gui now can scroll

Fix

- Music Data Pusher concurrent calling problem

Refactor

- Abstract layer for configs, events, networks and keybinds ---

兼容性

1.2.0 beta 1 或之后

平台

- 对(Bukkit系的) Paper/Purpur/Spigot/Folia 的实验性支持（感谢[MOPELotus](https://github.com/MOPELotus)）

功能

- 账户页中可见我收藏的专辑/歌手

改进

- HUD 中使用图标而不是文本指示状态 - API 服务器可用性检测 - 音乐加载提示 - Mod 描述 - 主界面左侧菜单可滚动

修复

- 服务端推送线程并发问题

重构

- 对配置、事件、网络、按键等服务的抽象层

Compatibility

1.2.0 beta 1 or later

Platform

- Experimental (Bukkit/)Paper/Purpur/Spigot/Folia support (thanks to [MOPELotus](https://github.com/MOPELotus))

Feature

- My subscribed albums / artists list in account view

Improve

- HUD now uses icons to notify now, instead of texts - Music API Server running detection - Intermediate progress bar when music is loading - Mod description - Left menu in gui now can scroll

Fix

- Music Data Pusher concurrent calling problem

Refactor

- Abstract layer for configs, events, networks and keybinds ---

兼容性

1.2.0 beta 1 或之后

平台

- 对(Bukkit系的) Paper/Purpur/Spigot/Folia 的实验性支持（感谢[MOPELotus](https://github.com/MOPELotus)）

功能

- 账户页中可见我收藏的专辑/歌手

改进

- HUD 中使用图标而不是文本指示状态 - API 服务器可用性检测 - 音乐加载提示 - Mod 描述 - 主界面左侧菜单可滚动

修复

- 服务端推送线程并发问题

重构

- 对配置、事件、网络、按键等服务的抽象层