自定义音乐+

🎵 CustomMusic+

CustomMusic+ 让你可以将自己的音乐带入 Minecraft —— 但目前仅支持 .ogg 音频文件。如果你的音乐是 .mp3 格式，需要先将其转换为 .ogg。一个快速简便的方法是使用 Audacity（免费）、VLC Media Player，或像 CloudConvert 这样的在线转换器。

CustomMusic+ 是一个轻量级的客户端 Fabric 模组，让你无需使用资源包或编辑声音文件，即可直接在 Minecraft 中添加、播放和管理自己的音乐和播放列表。

每个 Minecraft 实例（按版本或整合包）都有自己的 custommusic 文件夹，让你可以为每个配置拥有完全独特的配乐。

📂 文件夹结构 每个 Minecraft 版本都有自己独立的文件夹： .minecraft/ ├── 1.21.6/ │ └── config/ │ └── custommusic/ │ ├── chill.ogg │ ├── battle_theme.ogg │ ├── night.ogg │ └── playlists/ │ ├── chillvibes.txt │ └── boss_battle.txt

只需将你的 .ogg 曲目或基于文本的播放列表放入其中，CustomMusic+ 会在游戏启动时自动加载它们。

---

⚙️ 核心功能

✅ 直接从文件系统播放 .ogg 曲目
✅ 支持 .txt 播放列表按顺序播放
✅ 实例专属文件夹（非常适合多版本配置）
✅ 首次启动时自动创建文件夹
✅ 轻量级客户端模组 —— 无需服务器
✅ 在 /CustomMusic 下简单统一的命令系统
✅ 适用于所有支持 OpenAL 的 Fabric 版本

---

💬 命令

命令	描述
/CustomMusic play <name>	立即播放曲目或播放列表。
/CustomMusic stop	停止当前播放并清空队列。
/CustomMusic pause	暂停当前曲目或播放列表。
/CustomMusic resume	恢复暂停的播放。
/CustomMusic list	列出所有可用的曲目和播放列表。
/CustomMusic search <keyword>	搜索包含关键字的歌曲/播放列表。
/CustomMusic reload	重新扫描文件夹以查找新的音乐和播放列表。
/CustomMusic help	显示帮助和使用信息。

---

🧠 工作原理（技术摘要）

组件	作用
CustomMusicPlusClient	客户端入口点 —— 注册命令、处理刻和播放队列。
PlaylistManager	为 .ogg、.mp3 和 .txt 文件创建/扫描 custommusic 和播放列表文件夹。
OggDecoder	使用 LWJGL STB Vorbis 将 .ogg 解码为原始 PCM 数据。
AudioPlayer	使用 LWJGL OpenAL 处理播放（播放、停止、暂停、恢复）。

🔎 MP3 文件会被检测并列出，但尚不可播放 —— Minecraft 原生仅支持 .ogg。

---

🎮 使用示例

/CustomMusic play chillvibes 按顺序播放 playlists/chillvibes.txt 中的所有曲目

/CustomMusic search night 查找所有包含 "night" 的曲目和播放列表

🔮 计划功能

每曲目音量控制 随机与循环模式 “正在播放”覆盖层 通过 TinySound 或 FFmpeg 支持 MP3 解码 GUI 播放列表浏览器

🧩 兼容性

需求 信息 加载器 Fabric 环境 仅客户端 依赖 Fabric API 支持格式 .ogg（可播放），.mp3（仅列出）

❤️ 鸣谢

由 hindustani_gamer_fardin 开发和维护