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

All 11 images on Modrinth

Images: 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.

  1. 01

    Install the loader locally

    Install Fabric or Forge or NeoForge or Quilt for your Minecraft version in your launcher.

  2. 02

    Download the file

    Download the MineLights file for your loader and your exact Minecraft version, for example 26.3.

  3. 03

    Add it to the mods folder

    Put the .jar file in your local .minecraft/mods folder and remove older duplicates.

  4. 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
Original description by the project author

MineLights

output

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 /minelights commands.
  • 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.exe in the game's mods/MineLights folder for Fabric, Forge and NeoForge, or the game's MineLights folder 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)
  1. Install the latest OpenRGB version (recommended) if you want to use OpenRGB devices.
  2. After installing or updating OpenRGB, restart your computer before using MineLights.
  3. 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

  1. Launch Minecraft or Horizon: Start the game with your Fabric, Quilt, Forge, or NeoForge profile, or launch Horizon with MineLights enabled.
  2. 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,F4 chooses the health keys and /minelights set health-color #FF0000 sets their full-health color. Use /minelights list to 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; use none to 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!
  3. 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.

FAQ

MineLights questions

Question not listed? Ask our team.

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.

Looking for mods for your own server?

The catalog lists mods that run on Minecraft servers.

Browse all mods