Community listing page, reviews may not be monitored by the author.
Custom Music Player
No reviews yet
It provides NetEase Cloud Music search, song requests, shared queue playback, playlist playback, custom music discs, and URL-based jukebox playback.
Community voices
Reviews
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Compatibility
Supported Environments
Must be installed on both the client and the server.
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
About
Description
Minecraft Music Player (中文在下面)
Minecraft Music Player is a Fabric mod for both the server and the client: browse and request NetEase Cloud Music in game, with playlists and podcasts, real-time lyrics, network background music, burnable music discs, and jukebox playback.
The server handles commands, queues, configuration, and synchronization. The client handles audio playback and the UI. Install the mod on the server and on every client that needs to hear music.

Features
- Liquid glass UI: the music browser, settings, and disc burning share one visual style and animation set.
- Music browsing: search songs, playlists, artists, users, and podcasts; save playlists and view recently played.
- Requests and queue: request single songs, priority request queue, automatic playlist refill, vote skip.
- Playlists and podcasts: loaded in batches in the background, with sequential, reverse, and shuffle order.
- Real-time lyrics: supported for global playback and jukeboxes, toggled per player.
- Network background music: takes over vanilla background music, with a separate toggle and volume.
- Idle immersive: hides the HUD after a period of inactivity and overlays configurable effects and lyrics.
- Music discs: burn songs onto discs and play them in jukeboxes, with cover art and distance-based volume.
- Sharing: send playlists, artists, users, podcasts, or links to other players.
- Simplified Chinese, English, and Japanese included.
Music Browser
Open with the default key M; rebindable in Options → Controls.
- Left navigation: search, current queue, saved playlists, recently played, settings.
- Enter keywords in the search field, or paste a
music.163.comsong, playlist, or podcast link directly. - The search page switches between songs, playlists, artists, users, and podcasts.
- List rows support play and add to queue; playlists can be saved from their detail page, and song details show lyrics.
Idle Immersive
Enable it on the Client tab of the settings. After 60 seconds without keyboard or mouse input while music is playing, the mod hides the HUD and shows effects and lyrics; move the mouse or press any key to exit. The effect preset, background filter, idle delay, effect intensity, and lyric scale are configurable, and a preview is available.
Music Discs
- Craft a Music Disc Master from an iron ingot and an amethyst shard.
- Right-click the air while holding the master to open the burning screen, then search for and burn a song.
- Burned discs play in jukeboxes; the jukebox shows cover art and its volume fades with distance.
- Loot containers can generate random music discs; the chance and count are configurable.
Network Background Music
- The server picks the playlist through
bgmPlaylistId; it starts playing when players join. - Clients can toggle network background music and adjust its volume in
Options → Sound. - Falls back to vanilla background music when the API is unavailable.
Sharing
/music share <player> <playlist|artist|user|podcast|program|link> sends the content as a clickable message; recipients can click it to open it in the music browser.
Commands
Player commands:
| Purpose | Command |
|---|---|
| Playback control | /music now, /music seek <seconds>, /music skip, /music mute once |
| Requests | /music play song <song ID>, /music play playlist <playlist ID> [reverse], /music play program <program ID>, /music play radio <podcast ID> [reverse] |
| Queue | /music queue [page], /music queue promote <song ID>, /music queue remove <song ID> |
| Playback mode | /music playlist, /music playlist list, /music playlist stop, /music playlist order [sequential|reverse|shuffle] |
| Search | /music search <song|artist|playlist|user|radio> <keyword> [page <page>] |
| View | /music view <playlist|artist|user|radio|program> <ID> [page <page>], /music view <link> |
| Sharing | /music share <player> <same arguments as view> |
| Discs | /music burn song <song ID> |
| Other | /music random [refresh], /music join, /music leave, /music lyrics [on|off|status], /music help |
Admin commands:
| Purpose | Command |
|---|---|
| Playback management | /music pause, /music resume, /music skip, /music queue clear |
| Configuration | /music config reload, /music config status, /music config clearqueue, /music config set <key> <value>, /music config reset <key|bgmPlaylist|all> |
Configuration
All settings live in config/minecraft-music-player.json, split into shared server fields plus client, glass, and idle sections. Common keys:
| Key | Default | Description |
|---|---|---|
neteaseBaseUrl |
https://mycelis.dpdns.org/ |
Backend API address |
apiMode |
auto |
auto prefers direct connection, direct uses it only, proxy uses the backend only |
bgmPlaylistId |
18481322122 |
Network background music playlist; empty disables it |
proxy / useSystemProxy |
empty / true |
Manual proxy and system proxy |
preferIpv4 |
true |
Prefer IPv4 |
allowSongRequest / allowPlaylistRequest |
true |
Allow players to request songs / playlists and podcasts |
autoAdvance |
true |
Advance to the next track automatically |
searchLimit |
8 |
Items per page |
maxQueueSize / maxSongsPerPlayer |
40 / 5 |
Request queue limit and requests per player |
voteSkipPercent |
0.6 |
Vote skip ratio |
enableLootMusicDiscs |
true |
Random music discs in loot containers |
Minecraft Music Player
Minecraft Music Player 是一个 Fabric 双端音乐模组:在游戏内浏览、点播网易云音乐,支持歌单与播客、实时歌词、网络背景音乐、可刻录的音乐唱片和唱片机播放。
服务端负责命令、队列、配置与同步,客户端负责音频播放与界面。服务端和需要听歌的客户端都需要安装本模组。
功能
- 液态玻璃界面:音乐浏览器、设置、唱片刻录共用一套视觉与动画。
- 音乐浏览:搜索音乐、歌单、歌手、用户、播客,支持收藏歌单与最近播放。
- 点播与队列:单曲点播、单点队列优先、歌单自动补充、投票切歌。
- 歌单与播客:后台分批加载,支持正序、倒序、随机。
- 实时歌词:全局播放与唱片机均支持,按玩家独立开关。
- 网络背景音乐:接管原版背景音乐,可独立开关与调节音量。
- 挂机纯享:长时间无操作时隐藏 HUD,叠加可配置的视觉特效与歌词。
- 音乐唱片:将歌曲刻录到唱片,放入唱片机播放,封面与音量随距离变化。
- 内容分享:把歌单、歌手、用户、播客或链接分享给其他玩家。
- 内置简体中文、英文、日文。
音乐浏览器
默认快捷键 M 打开,可在 选项 → 控制 中修改。
- 左侧导航:搜索、当前队列、收藏的歌单、最近播放、设置。
- 搜索框输入关键词,或直接粘贴
music.163.com的单曲、歌单、播客链接。 - 搜索页可在音乐、歌单、歌手、用户、播客之间切换标签页。
- 列表行支持播放与加入队列;歌单详情页可收藏,歌曲详情页显示歌词。
挂机纯享
在设置「客户端」页开启。连续 60 秒没有键鼠输入且正在播放音乐时自动进入,隐藏 HUD 并显示特效与歌词;移动鼠标或按任意键退出。可配置特效预设、背景滤镜、触发时间、特效强度与歌词字号,并支持预览。
音乐唱片
- 使用铁锭与紫水晶碎片合成唱片母版。
- 手持母版右键空气打开刻录界面,搜索歌曲并刻录。
- 刻好的唱片放入唱片机播放,唱片机会显示封面,音量随距离衰减。
- 战利品箱有概率生成随机音乐唱片,概率与数量可配置。
网络背景音乐
- 服务端通过
bgmPlaylistId指定歌单,玩家进入游戏后自动播放。 - 客户端在
选项 → 声音中可开关网络背景音乐并调整音量。 - 接口不可用时自动回退原版背景音乐。
内容分享
/music share <玩家> <歌单|歌手|用户|播客|节目|链接> 会把内容以可点击消息发送给对方,对方点击即可在音乐浏览器中查看。
命令
玩家命令:
| 用途 | 命令 |
|---|---|
| 播放控制 | /music now、/music seek <秒>、/music skip、/music mute once |
| 点播 | /music play song <歌曲ID>、/music play playlist <歌单ID> [reverse]、/music play program <节目ID>、/music play radio <播客ID> [reverse] |
| 队列 | /music queue [页码]、/music queue promote <歌曲ID>、/music queue remove <歌曲ID> |
| 播放模式 | /music playlist、/music playlist list、/music playlist stop、/music playlist order [sequential|reverse|shuffle] |
| 搜索 | /music search <song|artist|playlist|user|radio> <关键词> [page <页码>] |
| 查看 | /music view <playlist|artist|user|radio|program> <ID> [page <页码>]、/music view <链接> |
| 分享 | /music share <玩家> <与 view 一致的参数> |
| 唱片 | /music burn song <歌曲ID> |
| 其他 | /music random [refresh]、/music join、/music leave、/music lyrics [on|off|status]、/music help |
管理员命令:
| 用途 | 命令 |
|---|---|
| 播放管理 | /music pause、/music resume、/music skip、/music queue clear |
| 配置管理 | /music config reload、/music config status、/music config clearqueue、/music config set <键> <值>、/music config reset <键|bgmPlaylist|all> |
配置
配置集中在 config/minecraft-music-player.json,分为服务端共用字段与 client、glass、idle 分节。常用键:
| 键 | 默认值 | 说明 |
|---|---|---|
neteaseBaseUrl |
https://mycelis.dpdns.org/ |
后端 API 地址 |
apiMode |
auto |
auto 直连优先、direct 仅直连、proxy 仅后端 |
bgmPlaylistId |
18481322122 |
网络背景音乐歌单,空值关闭 |
proxy / useSystemProxy |
空 / true |
手动代理与系统代理 |
preferIpv4 |
true |
优先使用 IPv4 |
allowSongRequest / allowPlaylistRequest |
true |
允许玩家点播单曲 / 歌单与播客 |
autoAdvance |
true |
播放结束后自动切歌 |
searchLimit |
8 |
每页显示数量 |
maxQueueSize / maxSongsPerPlayer |
40 / 5 |
队列上限与每位玩家点播上限 |
voteSkipPercent |
0.6 |
投票跳过所需比例 |
enableLootMusicDiscs |
true |
战利品箱随机唱片开关 |
Minecraft Music Player (中文在下面)
Minecraft Music Player is a Fabric mod for both the server and the client: browse and request NetEase Cloud Music in game, with playlists and podcasts, real-time lyrics, network background music, burnable music discs, and jukebox playback.
The server handles commands, queues, configuration, and synchronization. The client handles audio playback and the UI. Install the mod on the server and on every client that needs to hear music.

Features
- Liquid glass UI: the music browser, settings, and disc burning share one visual style and animation set.
- Music browsing: search songs, playlists, artists, users, and podcasts; save playlists and view recently played.
- Requests and queue: request single songs, priority request queue, automatic playlist refill, vote skip.
- Playlists and podcasts: loaded in batches in the background, with sequential, reverse, and shuffle order.
- Real-time lyrics: supported for global playback and jukeboxes, toggled per player.
- Network background music: takes over vanilla background music, with a separate toggle and volume.
- Idle immersive: hides the HUD after a period of inactivity and overlays configurable effects and lyrics.
- Music discs: burn songs onto discs and play them in jukeboxes, with cover art and distance-based volume.
- Sharing: send playlists, artists, users, podcasts, or links to other players.
- Simplified Chinese, English, and Japanese included.
Music Browser
Open with the default key M; rebindable in Options → Controls.
- Left navigation: search, current queue, saved playlists, recently played, settings.
- Enter keywords in the search field, or paste a
music.163.comsong, playlist, or podcast link directly. - The search page switches between songs, playlists, artists, users, and podcasts.
- List rows support play and add to queue; playlists can be saved from their detail page, and song details show lyrics.
Idle Immersive
Enable it on the Client tab of the settings. After 60 seconds without keyboard or mouse input while music is playing, the mod hides the HUD and shows effects and lyrics; move the mouse or press any key to exit. The effect preset, background filter, idle delay, effect intensity, and lyric scale are configurable, and a preview is available.
Music Discs
- Craft a Music Disc Master from an iron ingot and an amethyst shard.
- Right-click the air while holding the master to open the burning screen, then search for and burn a song.
- Burned discs play in jukeboxes; the jukebox shows cover art and its volume fades with distance.
- Loot containers can generate random music discs; the chance and count are configurable.
Network Background Music
- The server picks the playlist through
bgmPlaylistId; it starts playing when players join. - Clients can toggle network background music and adjust its volume in
Options → Sound. - Falls back to vanilla background music when the API is unavailable.
Sharing
/music share <player> <playlist|artist|user|podcast|program|link> sends the content as a clickable message; recipients can click it to open it in the music browser.
Commands
Player commands:
| Purpose | Command |
|---|---|
| Playback control | /music now, /music seek <seconds>, /music skip, /music mute once |
| Requests | /music play song <song ID>, /music play playlist <playlist ID> [reverse], /music play program <program ID>, /music play radio <podcast ID> [reverse] |
| Queue | /music queue [page], /music queue promote <song ID>, /music queue remove <song ID> |
| Playback mode | /music playlist, /music playlist list, /music playlist stop, /music playlist order [sequential|reverse|shuffle] |
| Search | /music search <song|artist|playlist|user|radio> <keyword> [page <page>] |
| View | /music view <playlist|artist|user|radio|program> <ID> [page <page>], /music view <link> |
| Sharing | /music share <player> <same arguments as view> |
| Discs | /music burn song <song ID> |
| Other | /music random [refresh], /music join, /music leave, /music lyrics [on|off|status], /music help |
Admin commands:
| Purpose | Command |
|---|---|
| Playback management | /music pause, /music resume, /music skip, /music queue clear |
| Configuration | /music config reload, /music config status, /music config clearqueue, /music config set <key> <value>, /music config reset <key|bgmPlaylist|all> |
Configuration
All settings live in config/minecraft-music-player.json, split into shared server fields plus client, glass, and idle sections. Common keys:
| Key | Default | Description |
|---|---|---|
neteaseBaseUrl |
https://mycelis.dpdns.org/ |
Backend API address |
apiMode |
auto |
auto prefers direct connection, direct uses it only, proxy uses the backend only |
bgmPlaylistId |
18481322122 |
Network background music playlist; empty disables it |
proxy / useSystemProxy |
empty / true |
Manual proxy and system proxy |
preferIpv4 |
true |
Prefer IPv4 |
allowSongRequest / allowPlaylistRequest |
true |
Allow players to request songs / playlists and podcasts |
autoAdvance |
true |
Advance to the next track automatically |
searchLimit |
8 |
Items per page |
maxQueueSize / maxSongsPerPlayer |
40 / 5 |
Request queue limit and requests per player |
voteSkipPercent |
0.6 |
Vote skip ratio |
enableLootMusicDiscs |
true |
Random music discs in loot containers |
Minecraft Music Player
Minecraft Music Player 是一个 Fabric 双端音乐模组:在游戏内浏览、点播网易云音乐,支持歌单与播客、实时歌词、网络背景音乐、可刻录的音乐唱片和唱片机播放。
服务端负责命令、队列、配置与同步,客户端负责音频播放与界面。服务端和需要听歌的客户端都需要安装本模组。
功能
- 液态玻璃界面:音乐浏览器、设置、唱片刻录共用一套视觉与动画。
- 音乐浏览:搜索音乐、歌单、歌手、用户、播客,支持收藏歌单与最近播放。
- 点播与队列:单曲点播、单点队列优先、歌单自动补充、投票切歌。
- 歌单与播客:后台分批加载,支持正序、倒序、随机。
- 实时歌词:全局播放与唱片机均支持,按玩家独立开关。
- 网络背景音乐:接管原版背景音乐,可独立开关与调节音量。
- 挂机纯享:长时间无操作时隐藏 HUD,叠加可配置的视觉特效与歌词。
- 音乐唱片:将歌曲刻录到唱片,放入唱片机播放,封面与音量随距离变化。
- 内容分享:把歌单、歌手、用户、播客或链接分享给其他玩家。
- 内置简体中文、英文、日文。
音乐浏览器
默认快捷键 M 打开,可在 选项 → 控制 中修改。
- 左侧导航:搜索、当前队列、收藏的歌单、最近播放、设置。
- 搜索框输入关键词,或直接粘贴
music.163.com的单曲、歌单、播客链接。 - 搜索页可在音乐、歌单、歌手、用户、播客之间切换标签页。
- 列表行支持播放与加入队列;歌单详情页可收藏,歌曲详情页显示歌词。
挂机纯享
在设置「客户端」页开启。连续 60 秒没有键鼠输入且正在播放音乐时自动进入,隐藏 HUD 并显示特效与歌词;移动鼠标或按任意键退出。可配置特效预设、背景滤镜、触发时间、特效强度与歌词字号,并支持预览。
音乐唱片
- 使用铁锭与紫水晶碎片合成唱片母版。
- 手持母版右键空气打开刻录界面,搜索歌曲并刻录。
- 刻好的唱片放入唱片机播放,唱片机会显示封面,音量随距离衰减。
- 战利品箱有概率生成随机音乐唱片,概率与数量可配置。
网络背景音乐
- 服务端通过
bgmPlaylistId指定歌单,玩家进入游戏后自动播放。 - 客户端在
选项 → 声音中可开关网络背景音乐并调整音量。 - 接口不可用时自动回退原版背景音乐。
内容分享
/music share <玩家> <歌单|歌手|用户|播客|节目|链接> 会把内容以可点击消息发送给对方,对方点击即可在音乐浏览器中查看。
命令
玩家命令:
| 用途 | 命令 |
|---|---|
| 播放控制 | /music now、/music seek <秒>、/music skip、/music mute once |
| 点播 | /music play song <歌曲ID>、/music play playlist <歌单ID> [reverse]、/music play program <节目ID>、/music play radio <播客ID> [reverse] |
| 队列 | /music queue [页码]、/music queue promote <歌曲ID>、/music queue remove <歌曲ID> |
| 播放模式 | /music playlist、/music playlist list、/music playlist stop、/music playlist order [sequential|reverse|shuffle] |
| 搜索 | /music search <song|artist|playlist|user|radio> <关键词> [page <页码>] |
| 查看 | /music view <playlist|artist|user|radio|program> <ID> [page <页码>]、/music view <链接> |
| 分享 | /music share <玩家> <与 view 一致的参数> |
| 唱片 | /music burn song <歌曲ID> |
| 其他 | /music random [refresh]、/music join、/music leave、/music lyrics [on|off|status]、/music help |
管理员命令:
| 用途 | 命令 |
|---|---|
| 播放管理 | /music pause、/music resume、/music skip、/music queue clear |
| 配置管理 | /music config reload、/music config status、/music config clearqueue、/music config set <键> <值>、/music config reset <键|bgmPlaylist|all> |
配置
配置集中在 config/minecraft-music-player.json,分为服务端共用字段与 client、glass、idle 分节。常用键:
| 键 | 默认值 | 说明 |
|---|---|---|
neteaseBaseUrl |
https://mycelis.dpdns.org/ |
后端 API 地址 |
apiMode |
auto |
auto 直连优先、direct 仅直连、proxy 仅后端 |
bgmPlaylistId |
18481322122 |
网络背景音乐歌单,空值关闭 |
proxy / useSystemProxy |
空 / true |
手动代理与系统代理 |
preferIpv4 |
true |
优先使用 IPv4 |
allowSongRequest / allowPlaylistRequest |
true |
允许玩家点播单曲 / 歌单与播客 |
autoAdvance |
true |
播放结束后自动切歌 |
searchLimit |
8 |
每页显示数量 |
maxQueueSize / maxSongsPerPlayer |
40 / 5 |
队列上限与每位玩家点播上限 |
voteSkipPercent |
0.6 |
投票跳过所需比例 |
enableLootMusicDiscs |
true |
战利品箱随机唱片开关 |
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Get it on
Available Platforms
On ModDex
Community snapshot
By the numbers