MineLights is a Minecraft Fabric mod that brings your world to life with dynamic RGB lighting effects for your peripherals. It targets the latest version of Minecraft (1.21+) and uses a modular design to support a wide range of hardware.
- 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: Use your keyboard's function keys as real-time status bars for health, hunger, and experience.
- Highly Configurable: An in-game configuration screen (via Mod Menu) lets you enable/disable every feature, integration, and even individual devices.
- 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).
- Minecraft Fabric: You must have the Fabric Loader installed.
- Mod Menu: Required to access the in-game configuration screen.
- (Optional) OpenRGB: If you want to use OpenRGB devices, make sure the OpenRGB server is running before you launch Minecraft.
- (Optional) All other RGB software: If you have any other hardware, ensure their official software is installed and running.
-
Download the LATEST MineLights Release Package:
- Go to the MineLights GitHub Releases page.
- Download the latest release
.zipfile that supports your Minecraft version (e.g.,MineLights-v2.0.0.zip). This is a complete package, not just a mod JAR!
-
Install MineLights (CRITICAL STEPS - Read Carefully!):
a. Locate the
MineLights-vX.X.X.zipfile you just downloaded.b. Extract the contents of this
.zipfile to a temporary location (e.g., your Desktop).c. After extracting, you will have a folder (e.g.,
MineLights-v2.0.0). Open this folder.d. Inside, you should see the mod's
.jarfile (e.g.,mine-lights-2.0.0.jar), and aMineLightsfolder (which contains other files essential for the mod to work).e. Select BOTH of these items (the
mine-lights-x.x.x.jarfile AND theMineLightsfolder) from inside the extracted folder.f. Copy these selected items and paste them directly into your Minecraft
modsfolder.Your
modsfolder should now look something like this (along with other mods you may have):.minecraft/ └── mods/ ├── mine-lights-2.0.0.jar <-- The JAR from the extracted MineLights package ├── MineLights/ <-- The 'MineLights' folder from the extracted MineLights package └── (other mods...)⚠️ IMPORTANT!- DO NOT just place the downloaded
MineLights-vX.X.X.zipfile into yourmodsfolder. - DO NOT just extract only the
mine-lights-x.x.x.jarfrom the zip and place it alone into themodsfolder. - The
MineLightsfolder MUST be present in yourmodsfolder alongside themine-lights-x.x.x.jarfor the mod to function correctly with iCue and Mystic Light. For OpenRGB, this is optional!
- DO NOT just place the downloaded
The mine-lights-x.x.x.jar file does not contain the proprietary SDK files from Corsair or MSI. To enable support for these, you must use the external MineLights.exe helper along with the libraries in the zip.
- Run the Helper:
- Double-click
MineLights.exein your .minecraft/mods/MineLights/ folder to run it. - For MSI Mystic Light support, you must right-click
MineLights.exeand select "Run as administrator". - A new icon will appear in your Windows System Tray to show that it's running.
- Double-click
- Run the MineLights Server (if needed): If you are on Windows and want anything beyond OpenRGB support, install and run
MineLights.exebefore you launch Minecraft. Remember to run it as an administrator for MSI hardware, either in the mod menu settings or manually. - Launch Minecraft: Start the game with your Fabric profile.
- Configure:
- In the main menu, go to Mods > MineLights > Config (the gear icon).
- Enable the integrations you want to use (OpenRGB, iCUE Proxy, etc.).
- Save the config.
- Refresh devices to show newly added devices.
- You can re-enter the config to disable speci 6FC8 fic devices if you wish.
- Enjoy! Your lighting will now sync with your game.
- 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!
Contributions are welcome! Please fork the repository and submit a pull request.
For any questions, suggestions, or bug reports, please open an issue on the GitHub repository.