# 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>
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }