🎵 Introduction

LuminaBox is a versatile background music manager mod for Minecraft. Whether you want to replace the vanilla background music with your own local MP3s, or stream music directly from online platforms like Bilibili, LuminaBox provides a sleek, in-game UI to manage it all.

✨ Features

In-Game Music Player: A fully-featured, draggable, and scalable UI to control playback, volume, and playlists without leaving the game.
Local Audio Support: Add your own music tracks from your computer directly into your Minecraft world.
Online Streaming: Search and stream music from Bilibili natively in-game (powered by LavaPlayer).
Custom Playlists: Create and manage both local and online playlists effortlessly.
Environmental Triggers: Automatically switch background music based on your environment, biomes, or server events.
Vanilla Override: Optionally replace all vanilla Minecraft background music with your curated tracks.
Multi-Loader Support: Available for both Fabric and NeoForge.
Multi-Language Support: Fully translated into 9 languages.

📥 Installation

Requirements

Minecraft 1.21.x
Fabric Loader OR NeoForge

Setup

Download the latest luminabox-[loader]-[version].jar release.
Drop the .jar file into your .minecraft/mods folder.
Launch the game and enjoy!

🎮 Usage

Open the Player: Press the designated hotkey (configurable in controls) or click the LuminaBox icon to open the Music Player UI.
Local Music: Navigate to the Local Music tab and add files from your computer.
Online Music: Navigate to the Search tab, search for your favorite tracks, and click the [+] button to add them to your Online Playlist.
Settings: Toggle features like Vanilla Music Replacement and Debug Logging in the Settings tab.

🌐 Network Proxy (For Online Streaming)

If you experience SocketTimeoutException or connectivity issues when streaming online music (especially Bilibili), you can configure an HTTP Proxy:

Open the Settings tab in the LuminaBox UI.
Enter your Proxy Host (e.g., 127.0.0.1) and Port (e.g., 7890).
Click Save Proxy.
Restart Minecraft for the proxy settings to take effect.

🛠️ Building from Source

To build LuminaBox yourself:

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

The compiled jars will be located in fabric/build/libs/ and neoforge/build/libs/.

📄 License

This project is licensed under the MIT License.