

Modrinth · Fabric, Forge, NeoForge, Quilt · Client mod
MineLights
MineLights is a client-side mod. Install it on your computer; the server does not need it.
MineLights is a Minecraft mod that brings RGB lighting integrations to Minecraft Java Edition and Horizon - OpenRGB, Corsair iCUE, Logitech G HUB, Razer Chroma, MSI Mystic Light, ASUS Aura, SteelSeries GameSense, and Wooting.
- Downloads
- 12.1K
- Author
- MegaBytesMe
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 1.10 – 26.3
- Updated
- –
Screenshots
What MineLights looks like
MineLights - Thunderstorm
Minecraft main screen
In-game - Savanna biome
In-game - Nether Portal
In-game - Warped ForestImages: MineLights on Modrinth, published by the project team.
Setup
Install MineLights on your client
Client-side mods only run on your computer. More server RAM does not change their performance.
- 01
Install the loader locally
Install Fabric or Forge or NeoForge or Quilt for your Minecraft version in your launcher.
- 02
Download the file
Download the MineLights file for your loader and your exact Minecraft version, for example 26.3.
- 03
Add it to the mods folder
Put the .jar file in your local .minecraft/mods folder and remove older duplicates.
- 04
Launch
Launch Minecraft with the loader profile. Nothing needs to change on the server.
- On the server
- Not needed
- On the client
- Required
- Loader
- Fabric, Forge, NeoForge, Quilt
- Minecraft
- 26.3, 26.2, 26.1.2 +58 more
- License
- Creative Commons Attribution Non Commercial Share Alike 4.0 International
Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
MineLights · Modrinth- MineLights 2.4.1 for 1.7.10 (Forge)November 16, 2026Minecraft 1.7.10 · Forge
- MineLights 2.4.1 for 26.3 (NeoForge)November 16, 2026Minecraft 26.3 · NeoForge
- MineLights 2.4.1 for 26.2 (NeoForge)November 16, 2026Minecraft 26.2 · NeoForge
- MineLights 2.4.1 for 1.21.10 (NeoForge)November 16, 2026Minecraft 1.21.10 · NeoForge
- MineLights 2.4.1 for 26.1 (NeoForge)November 16, 2026Minecraft 26.1, 26.1.1, 26.1.2 · NeoForge
Original description by the project author
MineLights
MineLights running on an Asus laptop. Video courtesy of Nukepatrol99.
MineLights is a Minecraft Fabric, Quilt, Forge, NeoForge and Horizon mod that brings your world to life with dynamic RGB lighting effects for your peripherals. It targets Minecraft versions from 1.14.3 onward on Fabric, 1.14.4 onward on Quilt, Forge releases from 1.7.2 onward, NeoForge releases from 1.20.2 onward and Horizon releases (latest nightly, for 26.3).
Currently supported: Minecraft 1.14.3 - 26.3 (Fabric), 1.14.4 - 26.3 (Quilt), 1.7.2 - 26.3 (Forge), 1.20.2 - 26.3 (NeoForge) and 26.3 - Latest nightly (Horizon)
Features
- Extensive Multi-SDK Support: Integrates with a wide array of RGB SDKs simultaneously, including OpenRGB, Corsair iCUE, Logitech G HUB, Razer Chroma, MSI Mystic Light, ASUS Aura, SteelSeries GameSense, and Wooting.
- Dynamic Environmental Effects: Your lighting changes in real-time based on your in-game surroundings.
- Biome Colors: Your keyboard's background color smoothly transitions to match the biome you're in.
- Weather Effects: Experience rain and dramatic lightning flashes during in-game thunderstorms.
- Status Effects: Your lighting will react when you are on fire, poisoned, or withering.
- Block Effects: Standing in lava, fire, or portals will trigger unique lighting themes.
- In-Game Status Bars: Show health, absorption, hunger, saturation, air, and experience on your chosen keyboard keys. On Minecraft 1.21.6 and later, a locator bar can also track players and waypoints.
- Compass: A compass on your numpad (Extended keyboards only) will appear, if you have either a compass or recovery compass in your inventory! Alternatively it can always be displayed via a toggle in settings.
- Highly Configurable: Change effect keys and colors, integrations, and individual devices through the settings screen and
/minelightscommands. - Multiple Languages: Support for English, Anglish, German and Chinese (Simplified) has been added (Along with some joke languages)
Supported RGB Software
- OpenRGB Full device support (DIRECT mode!). Requires OpenRGB - Windows, Linux and MacOS.
- Corsair iCUE: Full device support for keyboards, mice, headsets, and more via the iCUE SDK (requires Corsair iCUE - Windows).
- Logitech G HUB / Lightsync: Controls Logitech G keyboards, mice, headsets, and other Lightsync-enabled gear (requires Logitech G HUB - Windows).
- Razer Chroma: Extensive support for all Razer Chroma-enabled peripherals like keyboards, mice, and mousepads (requires Razer Synapse - Windows).
- MSI Mystic Light: Control for motherboards, GPUs, and other devices via the Mystic Light SDK (requires MSI Center - Windows).
- ASUS Aura Sync: Control for motherboards, GPUs, and other devices via the ASUS Aura SDK (requires Armoury Crate - Windows).
- SteelSeries GameSense: Integration with SteelSeries peripherals like keyboards, mice, and headsets (requires SteelSeries GG - Windows).
- Wooting: Direct, low-latency control for Wooting analog keyboards (requires Wootility software to be running - Windows).
- Novation: Support for Novation MIDI controllers like the Launchpad, enabling unique grid-based effects (Windows).
- Raspberry Pi Pico: Directly control custom DIY lighting projects powered by a Raspberry Pi Pico (Windows).
- Yeelights Directly control your Yeelights smarthome bulbs (Universal).
This project uses the RGB.Net Nuget package.
🛠️ Installation
Prerequisites
- Minecraft Fabric or Quilt: Install the matching Fabric or Quilt Loader.
- Minecraft NeoForge: Install NeoForge for the supported Minecraft version.
- Minecraft Forge: Install Forge for one of the supported Minecraft versions.
- Mod Menu: Required to access the in-game configuration screen.
- Cloth Config API: Required to access the in-game configuration screen.
- No Quilt API bundle required: MineLights runs on Quilt without QSL, QFAPI, or Fabric API.
- (Optional) OpenRGB: The latest OpenRGB version is recommended for OpenRGB devices.
- (Optional) All other RGB software: If you have any other hardware, ensure their official software is installed and running.
Installation
- On Fabric, Quilt, Forge or NeoForge, place the mod in your mods folder, then start Minecraft. On Windows, MineLights downloads MineLights Server when needed and checks for updates by default. To install it yourself, enable Manage MineLights Server manually in MineLights' server settings. This disables automatic downloads and replacements; configurable chat notices explain how to install or update the server. Place
MineLights.exein the game'smods/MineLightsfolder for Fabric, Forge and NeoForge, or the game'sMineLightsfolder for Quilt. The mod can start an installed server automatically.
Installing MineLights version 2.2: Simply place the mod in your mods folder, then start Minecraft. Follow the on-screen instructions.
Installing MineLights version 2.1 or below: Follow the guide in the release changelog.
OpenRGB setup (optional)
- Install the latest OpenRGB version (recommended) if you want to use OpenRGB devices.
- After installing or updating OpenRGB, restart your computer before using MineLights.
- Start OpenRGB, open the SDK Server tab, and click Start Server. Keep OpenRGB running while Minecraft is open. MineLights connects to the local server at
127.0.0.1:6742(the default SDK server address and port).
Usage
- Launch Minecraft or Horizon: Start the game with your Fabric, Quilt, Forge, or NeoForge profile, or launch Horizon with MineLights enabled.
- Configure:
- In the main menu, go to Mods > MineLights > Config (the gear icon).
- Enable the integrations you want to use (OpenRGB, Corsair iCUE, etc.).
- Save the config.
- Refresh devices to show newly added devices.
- You can re-enter the config to disable specific devices if you wish.
- Configure effect keys and colors in the available settings screen or with commands. For example,
/minelights set health-bar-keys F1,F2,F3,F4chooses the health keys and/minelights set health-color #FF0000sets their full-health color. Use/minelights listto see the available settings. - If OpenRGB reports a wrong LED name, use an override such as
/minelights set led-overrides Keyboard|1=F1. Separate multiple overrides with semicolons; usenoneto clear them. The device name matches part of the reported name and LED indexes appear in the game log. - OpenRGB lighting is restored outside worlds by default. You can choose a profile with
/minelights set outside-world-profile <profile name>; the profile is not loaded when that OpenRGB server contains disabled devices. - ⚠️: MSI Mystic Light integration requires you to restart the MineLights server as administrator to work!
- Enjoy! Your lighting will now sync with your game.
Roadmap
- Windows Dynamic Lighting: Integration with Windows Dynamic Lighting is planned for the future.
- Improve Device Compatibility: Continuously working to improve support for more devices across all SDKs.
- Community Testing: Ideally have testers, well test!
- Resolve Issues: I aim to resolve problems either within the issues page or issues I personally find and log.
Contributing
Contributions are welcome! Please fork the repository and submit a pull request.
Contact
For any questions, suggestions, or bug reports, please open an issue on the GitHub repository.
Does MineLights need to be installed on the Minecraft server?
No. Modrinth marks MineLights as unsupported on the server side. Install it only in your local mods folder. Your server can stay unchanged unless the project page lists an additional dependency.
Which version and loader does MineLights require?
Use a file for Fabric, Forge, NeoForge, Quilt and your exact Minecraft version. Supported versions include 26.3, 26.2, 26.1.2. Files for different loaders are not interchangeable.
MineLights is not working – what should I check?
First check the Minecraft version, loader version and required dependencies. Because the mod is client-side, more server RAM will not fix it.
Similar mods
Popular mods in the same category
Server-ready
VeinMiner
by Miraculixx
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
Server-ready
Geckolib
by Gecko
A 3D animation library for entities, blocks, items, armor, and more!
Client only
VeinMiner Hotkey
by Miraculixx
Veinminer Addon - Use a hotkey to veinmine with a dynamic crosshair & block highlighting
Server-ready
Fzzy Config
by fzzyhmstrs
Config API with automatic GUIs, powerful validation options, server-client sync, and more!
Looking for mods for your own server?
The catalog lists mods that run on Minecraft servers.