荏心音乐机 (CP Music Mod)
自定义音乐，随身随行！在服务器中与好友共享你的专属歌单！简介
荏心音乐机是一个轻量级但功能强大的 Fabric 模组，旨在解决多人游戏中的音乐分享难题。不再受限于原版唱片，你可以将本地的 .mp3 文件上传并刻录到自定义唱片中。最重要的是，我们引入了便携式随身听，让音乐不再局限于方块，而是跟随你移动，成为真正的“行走 BGM”！本模组经过深度网络优化，采用懒加载和本地缓存技术，确保在多人服务器中流畅运行，拒绝卡顿。
核心功能
- 自定义刻录系统：将任意 .mp3 文件刻录到空唱片上，支持最大 10MB 的单曲文件。
- 便携式随身听：不仅有放在地上的音乐机，还有拿在手里的随身听！音乐会跟随持有者移动，周围的玩家都能听到。
- 丰富的播放模式：支持顺序播放、单曲循环、随机播放和列表循环。
- 极致性能优化：
- 按需下载：只有听得到的玩家才会下载音乐数据。
- 永久缓存：下载过的音乐会自动保存在本地 (.minecraft/cp-cache/)，下次播放零延迟、零流量消耗。
- 防伪检测：自动识别并拦截伪造的 MP3 文件，防止客户端崩溃。
- 全局配置：支持通过指令调整广播距离，且配置持久化保存。
合成配方
- 空唱片：你需要它来承载音乐。
- 配方：黏土球 + 黑色染料 + 黏土球 (横向排列)。
- 刻录机：用于上传音乐并写入空唱片。
- 配方：(参考游戏内 JEI/REI，通常涉及玻璃板、红石、石英等)。
- 音乐机：放置在地上播放音乐的方块。
- 配方：(参考游戏内 JEI/REI)。
- 便携式随身听：
- 配方：铁锭 + 唱片机 + 铁锭 (中间行)，下方放 金锭。
- 唱片复制：
- 配方：已有唱片 + 黏液球 + 金锭 = 复制出的新唱片。
使用指南
- 刻录音乐：
- 放下刻录机，右键打开界面。
- 左侧放入空唱片。
- 点击“刻录”按钮，选择电脑中的 .mp3 文件（<10MB）。
- 等待上传完成，取出成品唱片。
- 播放音乐：
- 方块模式：将唱片放入音乐机，音乐将在固定范围内播放。
- 随身听模式：手持随身听右键打开界面，将多张唱片放入库存。点击播放按钮，音乐将跟随你移动！
- 控制：随身听界面支持上一首、下一首、暂停/播放以及切换循环模式。
指令介绍
- /cp distance 数值
- 功能：设置全局音乐广播距离（默认为 64 格）。
- 说明：修改后对所有播放机和随身听生效，数值越大传得越远（音量衰减越平缓）。
- /cp info
- 功能：查看当前设置的广播距离。
服务器环境注意事项
- 本模组需要服务端和客户端同时安装。
- 网络优化：模组内置了强大的防网络拥塞机制。多人同时听歌时，服务器只负责发送极小的控制指令，音频数据点对点传输且只传一次。
- 缓存：玩家的音频缓存位于 .minecraft/cp-cache。如果不想保留缓存，可以手动删除该文件夹。
