MineLights 2.3.1

This is a large update which focuses on new visual effects, expanded biome and lighting logic, and per‑device mapping - alongside multiple new Minecraft version targets (1.14.3 - 1.21.9) and optimisations to the server management workflow. Previous server version NOT compatible!

Key Features & Major Changes

• New Chat Pulse Effect:
• Keys bound to chat will now smoothly pulse white three times when a player message is received.
• Config option added to enable/disable this effect.
• Environmental & Weather Enhancements:
• Added dimming mode based on local light level or sky light level.
• Lightning flash effect now uses isLightningFlashing for accurate timing.
• Biome Colour Improvements:
• Comprehensive biome list added for 1.14.4 - 1.21.9 based on Yarn mappings, with adjusted colours to match map colours.
• Per‑Device LED Mapping:
• Standardised mapped key names before usage - Fixes OpenRGB integration on keyboards.
• Rain Effect Upgrade:
• Improved rain animation on RAM sticks and per‑key‑mapped devices.
• Server Management Optimisations:
• Faster update logic - triggers download, sends shutdown, and sets flags before starting server again.
• Updated URL for latest MineLights Server release.
• Added soul fire specific effect.

Installation / Upgrade Instructions

• DELETE your old mine-lights-*.jar file completely.
• Download the from this release.
• Place the new mine-lights-2.3.1.jar into your mods folder.
• Run Minecraft

For the best experience, also install Mod Menu and Cloth Config. Fabric API is required.

Full Changelog & Technical Details

• Added chat pulse effect when receiving a player message.
• Added config option for chat pulse effect.
• Added DTO and mixin/accessor for isChatMessageReceived.
• Added dimming mode based on local/sky light level; DTO and mixins for light level access.
• Added isLightningFlashing boolean and mixin for lightning properties.
• Added comprehensive biome list with official name resolution.
• Per‑device mapping refactor; standardised mapped key names.
• Improved rain effect on RAM sticks and per‑key devices.
• Integrated OpenRGB key mapping; expanded keymap.
• Logging improvements - total mapped keyboard keys.
• Updated server restart handling and release URL.
• Added new Minecraft targets: 1.21.8 (max 1.21.9), 1.21.6 (max 1.21.7), 1.21.2 (max 1.21.5), 1.20.5 (max 1.21.1), 1.20 (max 1.20.4), 1.19 (max 1.19.4), 1.17 (max 1.18.2), 1.16.2 (max 1.16.5), 1.16 (max 1.16.1), 1.15 (max 1.16), 1.14.4, 1.14.3.
• Minor fixes: removed unused imports, corrected name/version setting, fixed typos.

MineLights 2.3.1

This is a large update which focuses on new visual effects, expanded biome and lighting logic, and per‑device mapping - alongside multiple new Minecraft version targets (1.14.3 - 1.21.9) and optimisations to the server management workflow. Previous server version NOT compatible!

Key Features & Major Changes

• New Chat Pulse Effect:
• Keys bound to chat will now smoothly pulse white three times when a player message is received.
• Config option added to enable/disable this effect.
• Environmental & Weather Enhancements:
• Added dimming mode based on local light level or sky light level.
• Lightning flash effect now uses isLightningFlashing for accurate timing.
• Biome Colour Improvements:
• Comprehensive biome list added for 1.14.4 - 1.21.9 based on Yarn mappings, with adjusted colours to match map colours.
• Per‑Device LED Mapping:
• Standardised mapped key names before usage - Fixes OpenRGB integration on keyboards.
• Rain Effect Upgrade:
• Improved rain animation on RAM sticks and per‑key‑mapped devices.
• Server Management Optimisations:
• Faster update logic - triggers download, sends shutdown, and sets flags before starting server again.
• Updated URL for latest MineLights Server release.
• Added soul fire specific effect.

Installation / Upgrade Instructions

• DELETE your old mine-lights-*.jar file completely.
• Download the from this release.
• Place the new mine-lights-2.3.1.jar into your mods folder.
• Run Minecraft

For the best experience, also install Mod Menu and Cloth Config. Fabric API is required.

Full Changelog & Technical Details

• Added chat pulse effect when receiving a player message.
• Added config option for chat pulse effect.
• Added DTO and mixin/accessor for isChatMessageReceived.
• Added dimming mode based on local/sky light level; DTO and mixins for light level access.
• Added isLightningFlashing boolean and mixin for lightning properties.
• Added comprehensive biome list with official name resolution.
• Per‑device mapping refactor; standardised mapped key names.
• Improved rain effect on RAM sticks and per‑key devices.
• Integrated OpenRGB key mapping; expanded keymap.
• Logging improvements - total mapped keyboard keys.
• Updated server restart handling and release URL.
• Added new Minecraft targets: 1.21.8 (max 1.21.9), 1.21.6 (max 1.21.7), 1.21.2 (max 1.21.5), 1.20.5 (max 1.21.1), 1.20 (max 1.20.4), 1.19 (max 1.19.4), 1.17 (max 1.18.2), 1.16.2 (max 1.16.5), 1.16 (max 1.16.1), 1.15 (max 1.16), 1.14.4, 1.14.3.
• Minor fixes: removed unused imports, corrected name/version setting, fixed typos.

MineLights 2.2.1 - 1.14.4

This is a small update which:

• Introduces support for additional Minecraft versions (Fabric)
• Updated mod logo (made with love and MS Paint)
• Small refinements to core experience

Previous server version is compatible, as of MineLights 2.1!

Installation / Upgrade Instructions

1. DELETE your old mine-lights-*.jar file completely.
2. Download the mine-lights-2.2.1.jar from this release - corresponding to your game version.
3. Place the new mine-lights-2.2.1.jar into your mods folder.
4. Run Minecraft
   • If prompted, accept the download for the missing MineLights Server executable
   • If prompted for an update, choose “Update Now” to get the latest version

MineLights 2.2

This is a big update which:

• Introduces support (experimental) for Yeelight
• Adds support for the locator bar
• Adds a compass on the numpad keys
  • Configurable between being either a recovery compass or spawn compass
• Adds support for automatic MineLights Server executable management
  • Automatic updates when a newer version is available
  • Detects and warns if the executable is corrupt
  • Shows a dedicated prompt if the server is outdated or damaged, with options to update or skip
  • Automatically downloads MineLights Server if it is missing

Previous server version is compatible, as of MineLights 2.1!

Key Features & Major Changes

• Hardware Support Expansion: Support has been added via the official SDK:
  • Yeelight (Smarthome)
• Locator/Waypoint bar on 1–0 keys (overlays experience bar)
• Compass on numpad keys, configurable between recovery and spawn modes
• Automatic MineLights Server management:
  • Checks for updates via GitHub API using release tag
  • Verifies executable integrity with SHA‑256
  • Prompts user if outdated or corrupted, with “Update Now” or “Skip” options
  • Auto‑downloads if missing
• New Translations Added:
  • de_de.json – German
  • enp.json – Anglish
  • enws.json – Shakespearean English
  • en_au.json – Australian English
  • en_ca.json – Canadian English
  • en_gb.json – British English
  • en_nz.json – New Zealand English
  • en_pt.json – Pirate Speak (English)
  • en_ud.json – Upside Down English
  • en_us.json – American English
  • lol_us.json – LOLspeak
  • zh_cn.json – Simplified Chinese

Installation / Upgrade Instructions

1. DELETE your old mine-lights-*.jar file completely.
2. Download the mine-lights-2.2.0.jar from this release.
3. Place the new mine-lights-2.2.0.jar into your mods folder.
4. Run Minecraft
   • If prompted, accept the download for the missing MineLights Server executable
   • If prompted for an update, choose “Update Now” to get the latest version

Full Changelog & Technical Details

• Yeelight support
• Locator bar support – shows player locations on your experience bar
• Compass on numpad keys – recovery or spawn mode
• Added tooltip for experience bar config option
• Automatic MineLights Server management:
  • Tag‑based GitHub API update checks
  • SHA‑256 integrity verification
  • Outdated/corrupted executable prompt
  • Auto‑download if missing
• Retargeted for Minecraft 1.21.8 onwards
• New translations added:
  • de_de.json, enp.json, enws.json, en_au.json, en_ca.json, en_gb.json, en_nz.json, en_pt.json, en_ud.json, en_us.json, lol_us.json, zh_cn.json

MineLights 2.1

This is a large update that completely replaces the backend server, dramatically expanding hardware support and adding new features for a much smoother user experience. The original C++ server has been replaced with a new C# .NET-based application that makes use of RGB.Net for much larger device compatibility.

Previous server versions are not compatible.

Key Features & Major Changes

• Hardware Support Expansion: Support has been added for a large amount of new brands via their official SDKs:
  • Logitech (G HUB / Lightsync)
  • Razer (Chroma)
  • SteelSeries (GameSense)
  • Wooting
  • Novation (e.g., Launchpad)
  • Raspberry Pi Pico (for DIY projects)
• Automatic Server Management (Windows Only): The mod will now automatically start the MineLights.exe server if it isn't running and will monitor it, restarting it if it closes unexpectedly.
  • This feature can be disabled in the config screen if you prefer to manage the server manually.
• Complete Backend Rewrite
• Smarter Configuration: The in-game configuration screen now communicates directly with the new server. Enabling or disabling integrations will now reconfigure the server.
• OpenRGB Key Mapping: Keyboards controlled by OpenRGB should now correctly map named keys, enabling effects like the movement key highlighting on a wider range of hardware.
• Saturation/Oxygen bar on F9-F12 keys.

Installation / Upgrade Instructions

1. DELETE your old MineLights server folder and minelights-*.jar file completely.
2. Download and extract the MineLights-2.1.zip from this release: https://github.com/megabytesme/MineLights/releases/tag/v2.1.0
3. Place the new minelights-2.1.jar into your mods folder.
4. Place the entire MineLights folder (containing MineLights.exe) into your mods folder.
   • Your final folder structure should look like: .../.minecraft/mods/MineLights/MineLights.exe

Full Changelog & Technical Details

• Replaced the entire V1 C++ server with a new V2 implementation using .NET and the RGB.NET library.
• Added an auto-start and auto-restart monitor to the client for managing the server process on Windows.
• Added a server-side configuration file (config.json) to persist enabled integrations and disabled devices.
• Implemented a TCP handshake protocol where the client sends its configuration to the server, allowing the server to dynamically load or unload SDK providers.
• Added named key mapping for devices controlled via OpenRGB by parsing LED names during device enumeration.
• Refactored the build process to create a self-contained .NET application, bundling the runtime so no external installation is required.
• Embedded all required native SDK DLLs (iCUE, Mystic Light, etc.) into the server executable, which are extracted at runtime to simplify distribution.

• Added support for cross-platform devices (Windows, Linux, MacOS)
• Added support for OpenRGB
• Added support for MSI Mystic Light
• Added configuration options
• Improved responsiveness significantly
• Improved fluidity of animations
• Reduced CPU usage

• Added support for 1.21.5
• Minor client refactoring

• Added support for 1.21.4

Minelights

Changes:

• Biome colours are more accurately represented
• Player health (F1 - F4), hunger (F5 - F8) and experience (1-0) is now shown on function keys and number row
• Player health will show wither effect and poison effect
• Movement keys are now highlighted and adapt to the block you are in

How to upgrade

• Delete the old minelights jar and folder
• Unzip the new MineLights zipped folder into your "mods" folder. If asked, overwrite any files.

Initial MineLights release

Extract the zip file into the mods folder, you should be left with a "MineLights" folder in the mod folder, with the iCue SDK and MineLights.exe.