Description
# ℹ️ Fork Information
This mod is a direct fork of erykczy's [Colorful Lighting](https://github.com/erykczy/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](https://github.com/Camawama/colorful-lighting-sodium/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 (currently hosted on CurseForge):
* [Colorful Lighting for Supplementaries](https://www.curseforge.com/minecraft/texture-packs/colorful-lighting-for-supplementaries)
* [Colorful Lighting for Connected Glass](https://www.curseforge.com/minecraft/texture-packs/colorful-lighting-for-connected-glass)
* [Colorful Lighting for Tinted Campfires](https://www.curseforge.com/minecraft/texture-packs/colorful-lighting-for-tinted-campfires)
Want to make your own? The full resource pack tutorial is on the [GitHub page](https://github.com/Camawama/colorful-lighting-sodium).
# 🔗 Mod Compatibility
Supported & tested mods (click to expand)
* [Embeddium](https://modrinth.com/mod/embeddium): fully compatible and required
* [Starlight](https://modrinth.com/mod/starlight-forge) and [True Darkness](https://www.curseforge.com/minecraft/mc-mods/true-darkness-forge-updated-fork): work seamlessly
* [Oculus](https://modrinth.com/mod/oculus): a built-in auto-patcher makes colored lighting work with most shader packs automatically
* Dynamic light mods: [Sodium Dynamic Lights](https://modrinth.com/mod/sodium-dynamic-lights), [Torcy](https://www.curseforge.com/minecraft/mc-mods/torcy), [Dynamic Lights](https://www.curseforge.com/minecraft/mc-mods/dynamic-lights), and especially [Lively Lighting](https://modrinth.com/mod/lively-lighting), the recommended companion for colored dynamic, entity, and held-item lights
* [Wakes: Reforged](https://www.curseforge.com/minecraft/mc-mods/wakes-reforged): wakes are tinted accordingly
* [Flywheel](https://modrinth.com/mod/flywheel) / [Create](https://modrinth.com/mod/create): contraptions and Ponder scenes render with colored lighting
* [Valkyrien Skies](https://modrinth.com/mod/valkyrien-skies): colored lighting renders on ships (recently added, still being tested)
Found an incompatible mod? Report it on [GitHub Issues](https://github.com/Camawama/colorful-lighting-sodium/issues)!
# 🗺️ Roadmap
Where the project is headed (click to expand)
* 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](https://github.com/Camawama/colorful-lighting-sodium) for progress.
# ⚠️ Known Issues
Known issues and planned fixes (click to expand)
* [Distant Horizons](https://modrinth.com/mod/distanthorizons): lights inside LODs are not colored yet, fix in development
* [Flerovium](https://modrinth.com/mod/flerovium): held and dropped items appear dark, fix planned
* [AsyncParticles](https://modrinth.com/mod/asyncparticles): particles appear dark, fix planned
* [Immersive Portals](https://modrinth.com/mod/immersiveportals): 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](https://github.com/Camawama/colorful-lighting-sodium).