Melodix Music Player

Melodix 是一款客户端 Fabric 模组，让你在游戏时通过功能齐全的游戏内播放器，欣赏本地音乐文件或 Minecraft 自带的原声音乐。

✨ 功能特色

• Minecraft 原生界面：按下 M 即可打开完整播放器，浏览音乐库、管理播放队列并调整所有设置，无需离开游戏。
• 格式支持：兼容 .mp3、.wav 和 .flac 音频文件。
• 原版音乐控制：在同一界面中浏览并播放 Minecraft 内置音乐曲目。还可选择禁止 Minecraft 自动播放音乐，让你始终掌控播放内容。
• 自定义播放列表：创建、编辑和管理多个播放列表，满足不同游戏心情。
• 迷你播放器 HUD：紧凑、可拖动的叠加界面会始终在屏幕上显示当前曲目。
• 正在播放显示：以小组件或快捷栏上方的形式显示曲目信息，也可以完全关闭。
• 音频可视化：可选的频谱可视化效果会在播放时呈现在屏幕上。
• 专辑封面：显示 Minecraft 官方原声专辑的封面；自定义曲目则使用备用图片。
• 音效：提供带前级增益的五段均衡器、混响、曲目间淡入淡出、播放速度控制，以及暂停时渐弱。
• 收听统计：在专属统计界面查看每首曲目的收听时长。
• 喜欢的歌曲：将曲目标记为收藏，方便快速访问。
• 播放模式：顺序播放、随机播放和重复播放。
• 音量闪避：受到伤害时自动降低音乐音量，之后再自动恢复。
• 窗口焦点处理：可选择在 Minecraft 失去焦点时暂停音乐。
• 键盘快捷键：播放/暂停（P）、下一首（→）、上一首（←）、音量增大/减小（↑/↓），以及自定义快速调节音量的按键绑定；所有按键均可在原版“控制”菜单中重新绑定。
• 主题：在设置界面切换配色主题。

🖼️ 截图

播放器菜单

播放列表编辑器

设置菜单

🛠️ 安装

1. 安装 Fabric Loader 和 Fabric API。
2. 将 melodix-<version>.jar 放入 .minecraft/mods 文件夹。
3. 启动游戏。
4. 在游戏中按下 M 打开播放器。
5. 在设置界面中，将音乐文件夹路径设为包含 .mp3、.wav 或 .flac 文件的文件夹。

📦 前置依赖

• Fabric API — 必需
• Java 25 或更高版本 — 必需

📜 第三方库

已随模组一同打包，无需单独下载

• JLayer，由 JavaZoom 开发 — 用于处理 MP3 解码和播放。基于 LGPL 许可。