Back to mods
LuminaBox project artwork

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which LuminaBox release matches 26.1?

Updated 5 months ago
Best match for your filters luminabox-neoforge-26.1.x-1.0.1.jar
Game version 26.1, 26.1.1, 26.1.2
Loader NeoForge

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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 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

Setup

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

🎮 Usage

  1. Open the Player: Press the designated hotkey (configurable in controls) or click the LuminaBox icon to open the Music Player UI.
  2. Local Music: Navigate to the Local Music tab and add files from your computer.
  3. Online Music: Navigate to the Search tab, search for your favorite tracks, and click the [+] button to add them to your Online Playlist.
  4. 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:

  1. Open the Settings tab in the LuminaBox UI.
  2. Enter your Proxy Host (e.g., 127.0.0.1) and Port (e.g., 7890).
  3. Click Save Proxy.
  4. 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.

12 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

LuminaBox versions and loaders

2 of 6 releases match
Clear filters

Looking for an older file? The official CurseForge project page is in Resources.