CurseForge · Minecraft mod
LuminaBox
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.
Quick answer
Which LuminaBox release matches 26.1?
luminabox-neoforge-26.1.x-1.0.1.jar targets 26.1, 26.1.1, 26.1.2 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.
Where it goes
Is LuminaBox required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does luminabox-neoforge-26.1.x-1.0.1.jar need?
luminabox-neoforge-26.1.x-1.0.1.jar on 26.1. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add LuminaBox without breaking your instance.
Built for luminabox-neoforge-26.1.x-1.0.1.jar on 26.1. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use luminabox-neoforge-26.1.x-1.0.1.jar. It targets 26.1, 26.1.1, 26.1.2 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside luminabox-neoforge-26.1.x-1.0.1.jar. It opens that exact file at the source.
About this project
What does LuminaBox add?
🎵 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.
Project description from CurseForge.
Pick your setup
LuminaBox by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.1.2
2 loader builds26.1.1
2 loader builds26.1
2 loader builds1.21.1
2 loader builds1.21
2 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
LuminaBox versions and loaders
luminabox-neoforge-26.1.x-1.0.1.jar
19 Jun 2026
luminabox-fabric-26.1.x-1.0.1.jar
19 Jun 2026
Looking for an older file? The official CurseForge project page is in Resources.