游戏内音乐播放器

直接在《我的世界》中聆听您喜爱的本地曲目！这个模组在游戏中添加了一个时尚、功能完备且高度可定制的音乐播放器界面。导入您的音乐，管理您的音乐库，并完全在游戏中自定义您的体验——无需浏览文件或重启游戏。

✨ 功能特性

• 高级可主题化界面： 拥有简洁的界面，包含音乐库、正在播放和编辑器标签页。使用交互式主题预设（包含《我的世界》配色预设）个性化您的设置。您可以独立自定义选中高亮、拖放区域、内容背景和悬停颜色等细节，以完美匹配您的 HUD。

• 支持 .ogg 和 .mp3 格式： 完全原生支持 OGG 和 MP3 两种音频格式，让您轻松将现有音乐收藏带入《我的世界》。

• 完整歌词支持： 通过直接在播放标签页中显示的专属歌词界面，让您的曲目栩栩如生。在界面内轻松添加或编辑歌词，或使用文本文件快速导入。

• 游戏内文件导入： 直接通过游戏界面添加曲目。无需手动浏览配置文件夹或打开文件管理器。

• 即时游戏内编辑器： 完全掌控您的音乐库。通过界面或升级后的元数据/主题 JSON 编辑器，即时重命名歌曲标题、编辑艺术家名称、修改歌词以及分配封面缩略图。

• 无缝桌面集成： 所有界面文本框均支持真实 PC 剪贴板，可轻松从网站复制粘贴。所有编辑器（搜索、添加、编辑、歌词、十六进制字段和 JSON）均完全支持标准键盘快捷键。

• 全局按键绑定： 可在任何屏幕或菜单布局中打开音乐播放器或绑定菜单——无需加载到世界地图中即可更改设置。

• 实时文件扫描： 如果您在外部添加音乐，模组会在《我的世界》运行时自动检测新添加的文件。

• 完整播放控制： 包含您所需的一切——播放、暂停、跳过、上一首、重复和随机播放。

• 进度拖动与独立音量： 拖动进度条可快进/快退曲目，并可独立于《我的世界》主音量控制音乐播放器的音量。

• 性能优化： 专为低内存占用而设计，可处理超大音频文件，并优化图像处理，确保高分辨率封面艺术安全加载而不会导致游戏卡顿。

---

⚙️ 如何使用与设置

🎮 简易方式（游戏内）

1. 启动《我的世界》并使用您配置的按键（在控制设置中设置）打开音乐播放器。
2. 将您的 .ogg 或 .mp3 文件拖放到“添加”标签页中即可即时导入。
3. 打开编辑器标签页，直接在界面中重命名歌曲、编辑艺术家并分配封面图片。

---

📂 手动设置（可选）

更喜欢自己管理文件？您仍然可以：

1. 导航至 config/music_player
2. 将您的 .ogg 和/或 .mp3 文件放入该文件夹。
3. 将封面图片放入 config/music_player/covers/
4. 将曲目歌词文本文件放入 config/music_player/lyrics/
5. 可选：编辑 metadata.json 以自定义标题、艺术家和缩略图。

metadata.json 示例：

{
  "tracks": {
    "song1.ogg": {
      "title": "酷炫曲目",
      "artist": "Xeppy123",
      "thumbnail": "covers/song1.png",
      "lyrics": "lyrics/song1.txt"
    },
    "song2.mp3": {
      "title": "趣味曲目",
      "artist": "Indigo321",
      "thumbnail": "covers/song2.png"
    },
    "song3.ogg": {
      "title": "史诗曲目",
      "artist": "Gamer123",
      "thumbnail": "covers/song3.png",
      "lyrics": "lyrics/song3.txt"
    }
  }
}

📌 即将推出的功能

此模组正在积极开发中——期待未来更新中更多功能、体验优化和自定义选项。

路线图上的下一步是超越本地文件，将在线流媒体直接带入您的游戏内播放器：

• YouTube 音乐流媒体： 直接在游戏中流式播放 YouTube 的曲目和播放列表，无需下载任何文件。（lavaplayer）
• SoundCloud 集成： 在游戏时原生播放您喜爱的 SoundCloud 曲目、艺术家和混音。