自定义点唱机唱片

你磁盘上的任何 MP3 或 OGG 文件，都能变成可放入唱片机的音乐唱片。

GitHub · 报告 Bug

Minecraft 1.21.1 · NeoForge · 客户端和服务端都需要安装 · MIT 许可证

快速上手

1. 将你的 .mp3 或 .ogg 文件放入 .minecraft/customjukeboxdiscs/uploads
2. 合成一个唱片写入器（铁、红石、唱片机）和一些空白唱片（纸和铁粒）
3. 右键点击写入器，将空白唱片放入槽位，从列表中选择文件，点击写入
4. 取出唱片，放入任何普通的唱片机中

就这么简单。从此这张唱片就是一张真正的音乐唱片：漏斗可以搬运它，比较器可以读取它，敲掉唱片机会停止音乐，走远后音量会变小。

你能得到什么

• 通过原版唱片机播放你的音乐，使用“唱片”音量滑块，并具有正确的距离衰减
• 12 种唱片外观，写入时随机分配，因此一面唱片墙不会看起来像 12 个相同的物品
• 唱片架 —— 一个 9 格位的架子，可以展示内部的唱片。右键点击可取出唱片，潜行点击可像箱子一样打开整个架子。比较器可读取其装满程度
• 与精致背包 / 存储的唱片机升级兼容。背在背上的背包中播放的音乐会随你移动
• 按下 J 键可为你自己关闭自定义音乐。之后服务器将不再向你发送任何曲目，因此不消耗任何带宽
• 不进行任何转码，不捆绑任何在 Java 之外运行的内容。无 FFmpeg，无原生二进制文件，无遥测

如果你运行服务器

服务器决定一切。它会重新读取每个上传的文件，自行计算真实时长，并忽略客户端关于此的任何声明。

默认情况下只有管理员可以写入唱片。 这常常让第一天使用的人感到困惑。要开放权限：

/customdiscs access mode everyone
/customdiscs access mode allowlist
/customdiscs access allow <玩家>
/customdiscs access deny <玩家>

拒绝条目优先于一切，包括管理员身份。

查看和清理玩家写入的内容：

/customdiscs tracks list [页码]
/customdiscs tracks info <sha256>
/customdiscs tracks delete <sha256>
/customdiscs reload

默认限制，均可在 customjukeboxdiscs-server.toml 中编辑：

• 文件大小：10 MiB
• 曲目时长：10 分钟
• 每名玩家的曲目数：20
• 每名玩家的存储空间：100 MiB
• 每台服务器的存储空间：2 GiB
• 传输速率：每名玩家 512 KiB/s

曲目存储在世界文件夹中，以其内容哈希命名，因此五个人上传同一首歌只会占用一份磁盘空间。玩家下载一次曲目后即会为那个服务器缓存；再次收听不会产生额外流量。

从链接写入

默认关闭。开启 urlUploads.enabled 并列出你信任的主机，玩家就可以粘贴音频文件的 https 链接，而无需使用本地文件。服务器会下载该文件，并对其执行与上传完全相同的检查。

这不是一个流媒体模组。 它不能播放来自 YouTube、Spotify 或任何类似平台的内容，也永远不会支持。链接必须指向实际的音频文件——你自己的网站空间、互联网档案馆、免费音乐档案馆，或者你丢在 Discord 里的文件。

安装前需要了解的事项

• 客户端和服务端都需要安装该模组。仅服务端单独安装是无法工作的
• 音频会被降混为单声道。OpenAL 无法定位立体声源，而在世界中任何地方都音量相同的唱片，还不如一张能正常衰减的单声道唱片
• 只上传你被允许共享的音乐。服务器所有者可以选择谁可以写入唱片，并可以随时删除任何内容
• 欢迎整合包使用，无需询问