Back to mods
colorful-lighting sodium compat project artwork

CurseForge · Minecraft mod

colorful-lighting sodium compat

Colorful Lighting for minecraft 1.21.1 with NeoForge and sodium-iris shaderpacks

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

Quick answer

Which colorful-lighting sodium compat release should I use?

Updated 13 days ago
Latest stable file colorful_lighting-1.21.1-2.5.1.jar
Game version 1.21.1
Loader NeoForge

colorful-lighting sodium compat colorful_lighting-1.21.1-2.5.1.jar targets 1.21.1 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 colorful-lighting sodium compat 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 colorful-lighting sodium compat colorful_lighting-1.21.1-2.5.1.jar need?

colorful_lighting-1.21.1-2.5.1.jar. Change the file and its required mods may change too.

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.

2 listed on this file 1 pulled in by one of those mods
ScalableLux Optional for colorful-lighting sodium compat colorful_lighting-1.21.1-2.5.1.jar
optional
Matching file found Matched file: 0.1.0.1 for neoforge 1.21.1
Iris Shaders Optional for colorful-lighting sodium compat colorful_lighting-1.21.1-2.5.1.jar
optional
Matching file found Matched file: Iris 1.8.14 Beta 1 for NeoForge 1.21.1
Sodium Needed by Iris Shaders
pulled in
Matching file found Matched file: Sodium 0.8.13 for NeoForge 1.21.1

1 extra mod was pulled in by another dependency. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add colorful-lighting sodium compat without breaking your instance.

Built for colorful-lighting sodium compat colorful_lighting-1.21.1-2.5.1.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use colorful_lighting-1.21.1-2.5.1.jar. It targets 1.21.1 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 colorful_lighting-1.21.1-2.5.1.jar. It opens that exact file at the source.

About this project

What does colorful-lighting sodium compat add?

Colorful Lighting: Sodium/Iris Edition

A fork of erykczy's Colorful Lighting (MIT) that makes colored lighting work with Sodium and Iris shader packs, adds dynamic entity/item lights and an in-game light editor.

Features

  • Colored block light with per-block colors and stained-glass-style filters, propagated by a dedicated client-side engine — vanilla light values and gameplay are untouched
  • Dynamic entity & item lights on the colored engine (the LambDynamicLights idea, in color): burning entities, glow squids, dropped/held/framed items, and a Java API for stateful entity lights
  • In-game light editor (the mod's config screen): recolor, re-level, or disable any block, item, entity, or the burning-entity light without leaving the game, and export your overrides as a resource pack
  • Data-driven colors: resource packs or mods define emitters/filters in JSON, including blockstate-specific entries (yourmod:lamp[color=red]); F3 + T hot-reloads them
  • Sodium terrain support: colored light rides Sodium's compact chunk vertex format
  • Iris shader-pack support: supported pack families get colored block, entity, particle, held-item, and per-pixel moving lights injected into their own lighting (see the table below); unsupported packs are automatically sanitized and render correct vanilla-brightness light without the tint
  • Renderer integrations: Create contraptions (moving colored lights), Flywheel instancing, Sable sublevels, Veil
  • Client side only — join any server, remove the mod at any time without touching the world

Versions & requirements

Version Notes
Minecraft 1.21.1 NeoForge 21.1.x (tested with 21.1.241)
Sodium 0.8.13-beta.1 tested Optional. Minimum [0.8.13-beta.1,)
Iris 1.8.14-beta.1 tested Optional, requires Sodium. Minimum [1.8.14-beta.1,)

Sodium and Iris are detected at runtime: without them the mod uses the vanilla core-shader path (like upstream); with Sodium alone, terrain uses the compact-vertex path; with Sodium + Iris, the shader-pack integration activates as well. A startup log line reports the detected versions and whether the compatibility layer actually applied — include it in bug reports.

Optional mods the integrations were built and tested against (all detected at runtime, none required, Newer versions are allowed; if something breaks on a newer build, try the listed version first.):
ScalableLux 0.3.0-alpha, Sodium Extra 0.9.3,
Create 6.0.10 (with its bundled Flywheel),
Sable 2.0.4,
Veil 4.4.1,
Flerovium 1.1.2 ,

Supported shader packs

Complementary Unbound / Reimagined
BSL
MakeUp Ultra Fast

In-game editor & configuration

Open the mod's config screen (Mods → Colorful Lighting → Config) to edit lights live, no files needed:

  • Blocks & items and Entities categories, grouped into families (all beds, all candles, ...) with search; edit a whole family or a single member
  • Recolor (hex input or palette), change the level (slider), disable a light, or reset to defaults — including the burning-entity light
  • Changes apply immediately and persist to config/colorful_lighting/lights.json
  • Export turns your overrides into a ready-to-share resource pack
  • Applying values to a family never silently re-enables members you disabled individually; re-enabling is explicit (Reset)

Credits

  • erykczy (thecode) — the original Colorful Lighting (CurseForge · Modrinth)
  • The Sodium, Iris, and ScalableLux teams for the renderer stack this fork integrates with
  • The authors of Complementary, BSL, and MakeUp Ultra Fast / E-LITE — the shader packs this fork carries colored light into

Project description from CurseForge.

Pick your setup

colorful-lighting sodium compat by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

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

Recent files

colorful-lighting sodium compat versions and loaders

9 of 9 releases match

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