Mod
LuminaBox
No reviews yet
This mod is designed to completely redefine your Minecraft auditory experience by giving you full control over what plays in the background, without ever needing to minimize the game.
Includes quality of life improvements and small tweaks to enhance and customize gameplay.
Neoforge is a fork of the Minecraft Forge available for versions 1.20.1+ of Minecraft. Many Forge mods are compatible with Neoforge and vice versa.
Fabric is a mod loader for versions 1.14+ of Minecraft, particularly popular for client side and optimization mods.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
🎵 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].jarrelease. - Drop the
.jarfile into your.minecraft/modsfolder. - 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.
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources