Custom Music Player

Minecraft Music Player

Minecraft Music Player 是一款 Fabric 双端音乐模组，支持搜索网易云音乐、点歌、播放歌单和播客、网络背景音乐、实时歌词、自定义音乐唱片以及唱片机播放。

服务器负责处理命令、队列、配置和同步；客户端负责播放音频。请在服务器和所有需要听音乐的客户端上安装此模组。

功能

• 搜索歌曲、艺人、歌单、用户和播客
• 点歌：空闲时立即播放，否则加入队列
• 歌单和播客模式：分批加载曲目，支持顺序、倒序和随机播放
• 点歌队列优先；歌单队列会自动补充
• 投票跳过；点歌者和管理员可以立即跳过
• 快进和倒退、暂停、继续播放，并显示播放进度
• 全局播放和唱片机均支持实时歌词，并可由每位玩家单独开关
• 网络背景音乐：替换原版背景音乐，可单独开关并在声音设置中调节音量
• 分享内容：向其他玩家发送歌单、艺人、用户、播客、节目或链接
• 音乐唱片：将歌曲刻录到唱片上，并在唱片机中播放；唱片机音量会随距离渐弱
• 战利品容器中可随机生成音乐唱片
• 点击歌曲和播客标题可在浏览器中打开
• music.163.com支持歌曲、歌单和播客链接
• 带分页的列表，并支持点击操作
• 内置简体中文、英语和日语

运行要求

• Minecraft 26.3
• Fabric Loader 0.19.3 或更高版本
• Fabric API 0.161.0+26.3 或兼容版本
• Java 25
• 可访问的网易云音乐 API，默认使用 https://mycelis.dpdns.org/

安装

请在服务器和所有需要听音乐的客户端上安装此模组和 Fabric API。

客户端设置位于 Options -> Sound：

• 网络背景音乐：开关
• 背景音乐音量：0% – 100%

网络背景音乐歌单由服务器配置。主菜单始终使用默认 API 地址。

玩家命令

播放控制

命令	说明
/music now	显示当前曲目、播放进度和暂停状态
/music seek <seconds>	快进或倒退；正数表示快进
/music skip	跳过当前曲目；点歌者和管理员可立即跳过，其他玩家需要投票
/music mute once	将当前曲目静音，直到下一首开始播放

点歌

命令	说明
/music play song <song ID>	点播歌曲
/music play playlist <playlist ID>	按顺序播放歌单
/music play playlist <playlist ID> reverse	从最后一首开始播放歌单
/music play program <program ID>	播放单个播客节目
/music play radio <radio ID>	按顺序播放整个播客
/music play radio <radio ID> reverse	从最后一个节目开始播放播客

队列

命令	说明
/music queue [page]	查看请求队列
/music queue promote <song ID>	将歌曲移至队列顶部
/music queue remove <song ID>	从队列中移除歌曲

播放列表与播客

命令	说明
/music playlist	查看播放列表的播放状态
/music playlist list	查看已加载的播放列表曲目
/music playlist stop	停止播放列表模式
/music playlist order	显示当前播放顺序
/music playlist order sequential	按顺序播放
/music playlist order reverse	按倒序播放
/music playlist order shuffle	随机播放
/music radio	播客中心
/music radio hot [page]	热门播客
/music radio categories	播客分类

搜索

命令	说明
/music search song <keyword>	搜索歌曲
/music search artist <keyword>	搜索艺人；author是其别名
/music search playlist <keyword>	搜索播放列表
/music search user <keyword>	搜索用户
/music search radio <keyword>	搜索播客

所有搜索命令都可在关键词后接受 page <page>。

查看详情

命令	说明
/music view playlist <playlist ID> [page <page>]	查看播放列表详情和曲目
/music view artist <artist ID> [page <page>]	查看艺人详情和歌曲；author是其别名
/music view user <user ID> [page <page>]	查看用户创建的播放列表
/music view radio <radio ID> [page <page>]	查看播客详情和节目
/music view program <program ID>	查看节目详情
/music view <URL>	解析 music.163.com 歌曲、播放列表或播客链接

分享

命令	说明
/music share <targets> playlist <playlist ID> [page <page>]	分享播放列表
/music share <targets> user <user ID> [page <page>]	分享用户的播放列表
/music share <targets> artist <artist ID> [page <page>]	分享艺人的歌曲；author是其别名
/music share <targets> radio <radio ID> [page <page>]	分享播客
/music share <targets> program <program ID>	分享节目
/music share <targets> <URL>	分享链接内容

/music share接受与 /music view 相同的参数。目标可以是 @a、@p 或玩家名称，也支持多个目标。接收者可以点击消息查看内容。

其他

命令	说明
/music random [refresh]	生成10首随机热门歌曲
/music burn song <song ID>	将歌曲刻录到手持唱片
/music join	加入当前播放
/music leave	退出当前播放
/music lyrics [on|off|status]	切换、启用、禁用或查看歌词
/music help [subcommand]	显示帮助

管理员命令

命令	说明
/music skip	立即跳过当前曲目
/music pause	暂停播放
/music resume	继续播放
/music queue clear	清空请求队列
/music config reload	重新加载配置并清除来源缓存
/music config status	显示当前配置
/music config clearqueue	清空请求队列
/music config set <key> <value>	更改配置值
/music config reset <key|bgmPlaylist|all>	重置配置

配置

服务器配置：config/minecraft-music-player.json

键	默认值	说明
neteaseBaseUrl	https://mycelis.dpdns.org/	网易云 API 地址
bgmPlaylistId	18481322122	网络背景音乐播放列表；留空则禁用
proxy	留空	手动代理；none可清除代理
useSystemProxy	true	使用系统代理
preferIpv4	true	优先使用 IPv4
connectTimeoutSeconds / readTimeoutSeconds	10 / 20	连接和读取超时时间
allowCustomServer	true	允许更改 API 地址
allowSongRequest	true	允许点歌
allowPlaylistRequest	true	允许请求播放列表和播客
autoAdvance	true	自动播放下一首
announceQueueChanges	true	广播队列变更
showLoadingHints	true	显示加载提示
showLyrics	true	默认启用歌词
searchLimit	8	每页条目数
maxQueueSize	40	请求队列上限
maxSongsPerPlayer	5	每位玩家的请求上限
playlistQueueLimit	20	播放列表预加载上限
queueCacheSize	3	来源缓存大小
voteSkipPercent	0.6	投票跳过比例
enableLootMusicDiscs	true	启用随机战利品唱片
lootMusicDiscChance / lootMusicDiscCount	0.3 / 1	每个容器的概率和数量

使用 /music config set bgmPlaylist off 禁用 bgmPlaylistId，或使用 reset 恢复默认值。baseUrl 接受 default；proxy 接受 none。

客户端配置： config/minecraft-music-player-client.json

Key	Default	Description
enableNetworkBgm	true	启用网络背景音乐
bgmVolume	0.7	背景音乐音量

中文

Minecraft Music Player 是一个 Fabric 双端音乐模组，提供网易云音乐搜索、点播、歌单与播客播放、网络背景音乐、实时歌词、音乐唱片和唱片机播放。

服务端负责命令、队列、配置与同步；客户端负责音频播放。服务端和需要听歌的客户端都需要安装本模组。

功能

• 搜索歌曲、作者、歌单、用户、播客
• 单曲点播：空闲时立即播放，播放中自动加入队列
• 歌单与播客播放模式：后台分批加载，支持正序、倒序、随机
• 单点队列优先播放，歌单队列自动补充
• 投票跳过；点歌人和管理员可直接跳过
• 快进、快退、暂停、继续和进度显示
• 实时歌词：全局播放和唱片机均支持，开关按玩家保存
• 网络背景音乐：接管原版背景音乐，可在声音设置中独立开关和调节音量
• 分享查看内容：将歌单、作者、用户、播客、节目或链接分享给其他玩家
• 音乐唱片：把歌曲刻录到唱片，放入唱片机播放；唱片机音量随距离衰减
• 战利品箱随机音乐唱片
• 歌曲和播客标题可点击打开浏览器
• 支持 music.163.com 的单曲、歌单、播客链接
• 列表分页与点击操作
• 内置简体中文、英文、日文

依赖要求

• Minecraft 26.3
• Fabric Loader 0.19.3 或更高
• Fabric API 0.161.0+26.3 或兼容版本
• Java 25
• 可访问的网易云音乐 API，默认 https://mycelis.dpdns.org/

安装

服务端和需要听歌的客户端均需安装本模组及 Fabric API。

客户端在 选项 -> 声音 中可以设置：

• 网络背景音乐：开关
• 背景音乐音量：0% – 100%

网络背景音乐的歌单由服务端配置；主菜单始终使用默认 API 地址。

玩家命令

播放控制

命令	说明
/music now	查看当前播放、进度和暂停状态
/music seek <秒数>	快进或快退，正数快进，负数快退
/music skip	跳过当前歌曲，点歌人或管理员直跳，其他玩家投票
/music mute once	暂时静音当前歌曲，下一首自动恢复

点播

命令	说明
/music play song <歌曲ID>	点播单曲
/music play playlist <歌单ID>	按顺序播放歌单
/music play playlist <歌单ID> reverse	从最后一首开始播放歌单
/music play program <节目ID>	播放单个播客节目
/music play radio <播客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	查看当前播放顺序
/music playlist order sequential	正序播放
/music playlist order reverse	倒序播放
/music playlist order shuffle	随机播放
/music radio	播客中心
/music radio hot [页码]	热门播客
/music radio categories	播客分类

搜索

命令	说明
/music search song <关键词>	搜索歌曲
/music search artist <关键词>	搜索作者，author 等价
/music search playlist <关键词>	搜索歌单
/music search user <关键词>	搜索用户
/music search radio <关键词>	搜索播客

所有搜索命令均支持在关键词后追加 page <页码>。

查看详情

命令	说明
/music view playlist <歌单ID> [page <页码>]	查看歌单详情与曲目
/music view artist <作者ID> [page <页码>]	查看作者详情与歌曲，author 等价
/music view user <用户ID> [page <页码>]	查看用户创建的歌单
/music view radio <播客ID> [page <页码>]	查看播客详情与节目
/music view program <节目ID>	查看节目详情
/music view <链接>	解析 music.163.com 的单曲、歌单或播客链接

分享

命令	说明
/music share <目标玩家> playlist <歌单ID> [page <页码>]	分享歌单
/music share <目标玩家> user <用户ID> [page <页码>]	分享用户歌单
/music share <目标玩家> artist <作者ID> [page <页码>]	分享作者歌曲，author 等价
/music share <目标玩家> radio <播客ID> [page <页码>]	分享播客
/music share <目标玩家> program <节目ID>	分享节目
/music share <目标玩家> <链接>	分享链接内容

/music share 的参数与 /music view 一致，目标玩家可使用 @a、@p 或玩家名，支持多个目标。对方点击消息即可查看。

其他

命令	说明
/music random [refresh]	生成 10 首随机热门音乐
/music burn song <歌曲ID>	将歌曲刻录到主手唱片
/music join	加入当前播放
/music leave	退出当前播放
/music lyrics [on|off|status]	切换、开启、关闭或查看歌词
/music help [子命令]	查看帮助

管理员命令

命令	说明
/music skip	直接跳过当前歌曲
/music pause	暂停播放
/music resume	继续播放
/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

键	默认值	说明
neteaseBaseUrl	https://mycelis.dpdns.org/	网易云 API 地址
bgmPlaylistId	18481322122	网络背景音乐歌单，留空则关闭
proxy	空	手动代理，none清除
useSystemProxy	true	使用系统代理
preferIpv4	true	优先使用 IPv4
connectTimeoutSeconds/readTimeoutSeconds	10/20	连接与读取超时
allowCustomServer	true	允许修改 API 地址
allowSongRequest	true	允许玩家点歌
allowPlaylistRequest	true	允许点播歌单和播客
autoAdvance	true	播放结束后自动切歌
announceQueueChanges	true	广播队列变更
showLoadingHints	true	显示加载提示
showLyrics	true	默认开启歌词
searchLimit	8	每页显示数量
maxQueueSize	40	单点队列上限
maxSongsPerPlayer	5	每位玩家同时点播上限
playlistQueueLimit	20	歌单预载上限
queueCacheSize	3	音源缓存数量
voteSkipPercent	0.6	投票跳过所需比例
enableLootMusicDiscs	true	启用战利品箱随机唱片
lootMusicDiscChance/lootMusicDiscCount	0.3/1	生成概率与每箱数量

bgmPlaylistId可用/music config set bgmPlaylist off关闭，reset恢复默认；baseUrl可设为default；proxy可设为none。

客户端配置：config/minecraft-music-player-client.json

键	默认值	说明
enableNetworkBgm	true	启用网络背景音乐
bgmVolume	0.7	背景音乐音量