Renxin Music Player

🎵 仁心音乐机（CP Music Mod）
自定义音乐，如影随形！在服务器上与好友分享你的歌单！

📖 简介
仁心音乐机是一个轻量却强大的 Fabric 模组，旨在解决多人游戏中的音乐分享难题。不再局限于原版唱片，你可以将本地的 .mp3 文件上传并刻录到自定义唱片上。最重要的是，我们引入了便携式随身听，让音乐随你移动，使你成为一个行走的 BGM 播放器！

本模组深度优化了网络，采用懒加载与本地缓存技术，确保在多人服务器中流畅运行、毫无卡顿。

✨ 主要特性
📀 自定义刻录系统：将任意 .mp3 文件刻录到空白唱片上（支持最大 10MB 的文件）。

🎧 便携式随身听：不再只是固定的唱片机方块，而是手持播放器！音乐跟随持有者，周围的玩家也能听到。

🔄 播放模式：支持顺序播放、单曲循环、随机播放和列表循环模式。

⚡ 性能优化：

按需下载：只有听觉范围内的玩家才会下载音乐数据。

永久缓存：下载的音乐会自动保存到本地（.minecraft/cp-cache/），确保重播时零延迟、零带宽占用。

防崩溃：自动检测并拦截伪造的 MP3 文件，防止客户端崩溃。

🛠️ 全局配置：通过命令调整广播距离，并持久保存。

🧩 合成配方
空白唱片：音乐的基础物品。

配方：黏土球 + 黑色染料 + 黏土球（水平排列）。

音乐刻录机：用于上传音乐并写入空白唱片。

配方：在游戏内查看 REI/JEI。

音乐播放器：放置在地面上播放音乐的方块。

配方：在游戏内查看 REI/JEI。

便携式随身听：

配方：铁锭 + 唱片机 + 铁锭（中间一行），下方放金锭。

唱片复制：

配方：现有唱片 + 黏液球 + 金锭 = 复制出的唱片。

🎮 使用方法
刻录音乐：

放置音乐刻录机，右键打开 GUI。

将空白唱片放入输入槽。

点击“刻录”按钮，从电脑中选择一个 .mp3 文件（<10MB）。

等待上传完成，取走你的自定义唱片。

播放音乐：

方块模式：将唱片放入音乐播放器。音乐在固定区域内播放。

随身听模式：手持便携式随身听，右键打开 GUI，将多张唱片放入其物品栏。点击播放，音乐便跟随你！

控制：随身听 GUI 支持上一首、下一首、播放/暂停以及循环模式切换。

💻 命令
/cp distance

说明：设置全局音乐广播距离（默认：64 格）。

注意：对所有玩家和机器生效。数值越大，声音传播越远，衰减越平滑。

/cp info

说明：查看当前的广播距离设置。

⚠️ 服务器注意事项
本模组必须在服务端和客户端同时安装。

网络优化：模组内置防拥塞机制。当多名玩家同时收听时，服务器只发送极小的控制数据包；音频数据在请求时点对点传输，且仅传输一次。

缓存：音频缓存存储在 .minecraft/cp-cache 中。如有需要，可手动删除此文件夹以释放空间。