ℹ️ Fork Information

This mod is a direct fork of erykczy's Colorful Lighting. Our main goal with this fork is to extend mod compatibility for use in 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. All the heavy lifting happens on a background thread, so your game stays smooth, and every color can be customized with a resource pack. Works on ANY server, no server-side install needed!

✨ Features

• Different blocks can emit different colors
• Light changes color when passing through stained glass and other filters
• Light can be absorbed by specific blocks
• Colors are fully customizable through resource packs
• Block states and even NBT can define different colors (a beacon lit by its effect, a charged creeper, a potion by its type)
• 100% client-side: use it 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 full resource pack tutorial is on the GitHub page.

🔗 Mod Compatibility

• Embeddium: fully compatible and required
• Starlight and True Darkness: work seamlessly
• Oculus: a built-in auto-patcher makes colored lighting work with most shader packs automatically
• Dynamic light mods: Sodium/Embeddium Dynamic Lights, Torcy, Dynamic Lights, and especially Lively Lighting, the recommended companion for colored dynamic, entity, and held-item lights
• Wakes: Reforged: wakes are tinted accordingly
• Flywheel / Create: contraptions and Ponder scenes render with colored lighting
• Valkyrien Skies: colored lighting renders on ships (recently added, still being tested)

Found an incompatible mod? Report it on GitHub Issues!

🗺️ Roadmap

• Full support for Sodium itself, alongside Embeddium
• Fabric, Forge and NeoForge support for every Minecraft version from 1.20.1 up to 26.2 (no backports below 1.20.1)
• A new shader patcher with dedicated patches for specific shader packs, with the current auto-patcher staying as the fallback

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

⚠️ Known Issues

• Distant Horizons: lights inside LODs are not colored yet, fix in development
• Flerovium: held and dropped items appear dark, fix planned
• AsyncParticles: particles appear dark, fix planned
• Immersive Portals: Nether light can bleed into the Overworld while a portal is rendered

🔬 Want the Technical Breakdown?

The full documentation, including the complete resource pack tutorial (emitters, filters, absorbers, entity/item lights, NBT rules), the client config guide, and all the technical details, lives on the GitHub page.