幻音

🎵 PhantomSound

PhantomSound 是一款轻量且快速的 Minecraft 音乐播放器模组，让你在探索、建造或与怪物战斗时享受自己的配乐。无需再切换窗口到外部播放器——只需按下 M 键，即可让喜欢的曲目直接在游戏内播放。

---

✨ 功能特性

• 🎧 支持播放 MP3、WAV 和 OGG Vorbis 文件
• ⌨️ 使用 M 键打开——快速便捷
• 📋 曲目列表带有当前曲目状态指示器（▶ 播放中、⏸ 已暂停、■ 已停止）
• 🎮 按钮：播放、暂停、停止、下一首、上一首
• 📁 文件夹按钮——直接在文件资源管理器中打开音乐文件夹
• 🔇 播放曲目时自动降低原版 Minecraft 音乐音量
• ⏸️ 支持断点续播的暂停——从上次停止的确切位置继续播放
• ⚡ 轻量（约 400 KB），为流畅运行而优化

---

📦 安装方法

1. 为 Minecraft 1.21.4 安装 Fabric Loader
2. 下载 PhantomSound .jar 文件
3. 将其放入 .minecraft/mods/ 文件夹
4. 启动游戏
5. 按下 M 键打开播放器

---

🎼 如何添加你的音乐

音乐文件夹会在首次启动时自动创建：

.minecraft/config/musicplayer/music/

或者直接点击播放器中的 📁 按钮——它会直接在文件资源管理器中打开该文件夹！只需将音频文件拖入，它们就会出现在曲目列表中。

---

📀 支持的格式

格式	说明
MP3	MPEG-1 Layer 3
WAV	未压缩的 PCM
OGG	OGG Vorbis

---

🎮 操作控制

按键	功能
M	打开 / 关闭播放器
播放	开始播放
暂停	暂停（进度会保存）
停止	停止播放
下一首	播放下一首曲目
上一首	播放上一首曲目
📁	在文件资源管理器中打开音乐文件夹

---

🛠️ 故障排除

• MP3 无法播放？ 尝试通过 cloudconvert.com 进行转换，然后重新添加到音乐文件夹中。
• 没有声音？ 请检查 Minecraft 中的音量设置。

---

📬 联系方式

发现 Bug 或有建议？请在模组页面留言——我会阅读所有评论！

---

作者： Black274121
许可证： MIT