Colorful Lighting: Sodium/Embeddium Edition

ℹ️ Fork Information

This mod is a direct fork of erykczy's Colorful Lighting. The goal of this fork is to expand compatibility with mods, renderers, and shader packs, making colorful lighting practical for larger modpacks. If you find an incompatible mod, please report it on the GitHub Issues page.

❓ How It Works

Every light source gets a color, and that color spreads through the world just like vanilla light. Filters like stained glass tint the light passing through them, while absorbers can remove colored light entirely.

Everything runs on a background thread so gameplay stays smooth while colored light propagates. The mod also smoothly blends colors between blocks for a more natural appearance.

The entire mod is client-side, so you can use it on ANY server without requiring the server to install anything.

✨ Features

• Different blocks emit different colors
• Light changes color when passing through filters such as stained glass
• Blocks can absorb colored light
• Colors are fully customizable through resource packs
• Block states and NBT can define different colors
• Modded light sources automatically glow using colors sampled from their own textures when no configuration exists
• Water subtly tints light using the biome's water color, becoming stronger over distance
• Works completely client-side on any server

🎨 Resource Pack Addons

Ready-made addon packs that add colored lighting entries for popular mods:

• Colorful Lighting for Supplementaries
• Colorful Lighting for Connected Glass
• Colorful Lighting for Tinted Campfires

Want to make your own? The complete resource pack guide is available on the GitHub page.

🔗 Mod Compatibility

• Embeddium: fully supported and recommended, but no longer required
• Vanilla rendering: fully supported
• Starlight and True Darkness: fully compatible
• Oculus: automatic shader patching for supported shader packs, with a generic patcher for everything else
• Dynamic light mods: Sodium/Embeddium Dynamic Lights, Torcy, Dynamic Lights, and especially Lively Lighting for colored entity and held-item lights
• Wakes: Reforged: wake effects are tinted correctly
• Flywheel / Create: contraptions and Ponder scenes render with colored lighting
• Valkyrien Skies: ships render with colored lighting
• Epic Fight: player and mob models render correctly
• Flerovium: held items, dropped items, and block breaking overlays render correctly
• AsyncParticles: particles render correctly
• HBM's Nuclear Tech Modernized: machine rendering compatibility

Found an incompatible mod? Report it on GitHub Issues!

🗺️ Roadmap

• Full support for Sodium
• Fabric, Forge and NeoForge support across Minecraft 1.20.1 through 1.26.x
• More dedicated shader patches while keeping the generic auto-patcher as a fallback

No timelines are promised; follow the GitHub repository for progress.

⚠️ Known Issues

• Distant Horizons: LOD lighting is not colored yet
• Cracker's Wither Storm Mod: currently incompatible

🔬 Want the Technical Breakdown?

The full documentation (including resource pack creation, emitters, filters, absorbers, entities, items, NBT rules, client configuration, shader patching, and implementation details) is available on the GitHub page.