流光音匣

流光音匣

这个模组旨在通过让你完全控制后台播放的内容，彻底重新定义你的《我的世界》听觉体验，全程无需最小化游戏。

🎵 简介

LuminaBox 是一款功能丰富的 Minecraft 背景音乐管理模组。无论你是想用本地的 MP3 文件替换原版背景音乐，还是直接从 Bilibili 等在线平台流式播放音乐，LuminaBox 都能提供一个精美的游戏内界面供你管理所有内容。

✨ 功能特性

  • 游戏内音乐播放器：功能完整、可拖拽且支持缩放的 UI，让你无需离开游戏即可控制播放、音量与播放列表。
  • 本地音频支持：直接将电脑上的音乐曲目添加至你的 Minecraft 世界。
  • 在线流媒体：在游戏中原生搜索并播放来自 Bilibili 的音乐（基于 LavaPlayer 实现）。
  • 自定义播放列表：轻松创建并管理本地与在线播放列表。
  • 环境触发：根据你的环境、生物群系或服务器事件自动切换背景音乐。
  • 原版替换：可选地使用你精选的曲目替换所有 Minecraft 原版背景音乐。
  • 多加载器支持：同时支持 Fabric 和 NeoForge。
  • 多语言支持：已完整翻译成 9 种语言。

📥 安装

需求

设置

  1. 下载最新版本的 luminabox-[加载器]-[版本].jar 发行包。
  2. 将 .jar 文件放入你的 .minecraft/mods 文件夹。
  3. 启动游戏，尽情享受！

🎮 使用说明

  1. 打开播放器：按下指定的快捷键（可在控制设置中配置）或点击 LuminaBox 图标，打开音乐播放器 UI。
  2. 本地音乐：切换到“本地音乐”标签，从电脑中添加文件。
  3. 在线音乐：切换到“搜索”标签，搜索喜爱的曲目，点击 [+] 按钮将其添加至在线播放列表。
  4. 设置：在“设置”标签中切换诸如“替换原版音乐”和“调试日志”等功能。

🌐 网络代理（用于在线流媒体）

如果在流式播放在线音乐（尤其是 Bilibili）时遇到 SocketTimeoutException 或连接问题，你可以配置一个 HTTP 代理：

  1. 打开 LuminaBox UI 中的 设置 标签。
  2. 输入你的代理 主机（例如 127.0.0.1）和 端口（例如 7890）。
  3. 点击 保存代理。
  4. 重启 Minecraft 以使代理设置生效。

🛠️ 从源码构建

要自行构建 LuminaBox：

git clone https://github.com/yourusername/LuminaBox.git
cd LuminaBox
./gradlew clean build

编译好的 jar 文件将位于 fabric/build/libs/ 和 neoforge/build/libs/ 中。

📄 许可协议

本项目采用 MIT 许可证。