# Tschipcraft's Dynamic Lights

> Server-side dynamic lighting for 1.17-1.21x >

> > For heavily modded setups, modpacks, as well as for playing on external servers, I recommend [LambDynamicLights](https://modrinth.com/project/yBW8D80W) or similar **client-side** mods instead. > [-> For details, check this wiki page](https://github.com/Tschipcraft/dynamiclights/wiki/Tschipcraft%27s-Dynamic-Lights-vs.-LambDynamicLights-%26-others). ## 💡 Features This data pack/mod brings dynamic lighting to Minecraft without any client-side requirements. Supported entities and items (like torches, glowstone, or enchanted gear), held or worn by players, mobs, or placed in item frames, will emit light using the [light block](https://minecraft.wiki/w/Light_(block)) added in Snapshot 21w13a. * [**50+ supported vanilla items**](https://github.com/Tschipcraft/dynamiclights/wiki/Supported-Items) out of the box * **Multiple light levels**: 3, 6, 9, 12, and 15 * **Water-sensitive behavior** with sounds for some items * **Enchanted items** glow by default (light level 6), with special cases for Fire Aspect, Riptide, Channeling (light level 9) * **Amethyst-trimmed armor** emits light * **Mobs, falling blocks, and display entities** can emit light if carrying a supported item * ~~**Curios API support** for modded inventory slots~~ See issue [#76](https://github.com/Tschipcraft/dynamiclights/issues/76) Since this project is completely server-side, players joining a server with Dynamic Lights installed will not need to install anything on their end for it to work! However, you can still use the mod version on the client for single-player worlds only. Joining a server that does not have Dynamic Lights installed will have no effect. [-> For a complete list of supported items & entities, and available settings, take a look at the wiki <-](https://github.com/Tschipcraft/dynamiclights/wiki) ## ℹ️ Limitations Since this is a data pack at its core, there are some limitations compared to other purely modded solutions.

Limitations (click to expand)

- Dynamic Lights may stutter while moving around. This project solely relies on vanilla light blocks, which are restricted to the block grid. Smooth transitions between blocks are not feasible - This pack currently uses marker entities to keep track of dynamic light positions. If these entities are cleared by you or plugins like [EntityTrackerFixer](https://www.spigotmc.org/resources/entitytrackerfixer-1-13-1-20-6-support-optimize-your-server.114924/), light blocks will be left behind. See issue [#25](https://github.com/Tschipcraft/dynamiclights/issues/25) - Vanilla light blocks are unfortunately immovable by pistons and block explosion damage. This can cause some redstone contraptions to malfunction. Please report any issues, I try to prevent common cases. See e.g. fixed issues [#51](https://github.com/Tschipcraft/dynamiclights/issues/51), [#15](https://github.com/Tschipcraft/dynamiclights/issues/15), [#12](https://github.com/Tschipcraft/dynamiclights/issues/12), [#10](https://github.com/Tschipcraft/dynamiclights/issues/10) - In Minecraft 1.21.4 and below, dynamic light updates will always trigger block updates. This could cause floating blocks affected by gravity, like sand or gravel, to fall - Some shader packs that ignore the vanilla lightmap, such as [Rethinking Voxels](https://modrinth.com/project/kmwfVOoi), will not display the dynamic lights. See issue [#59](https://github.com/Tschipcraft/dynamiclights/issues/59) - Dynamic Lights cannot function in 1x1 block spaces occupied by non-solid blocks, as there is simply no space for placing light blocks. See issues [#39](https://github.com/Tschipcraft/dynamiclights/issues/39) and [#43](https://github.com/Tschipcraft/dynamiclights/issues/43) - Dynamic Lights per player operate globally. [See a detailed explanation here](https://github.com/Tschipcraft/dynamiclights/issues/3#issuecomment-1450437262)

## 🔧 Installation & Use Install either as: * **Data Pack [DP]** ➜ Place `.zip` in your world's `datapacks` folder * **Mod [Mod]** ➜ Drop into your `mods` folder and optionally install [MidnightLib](https://modrinth.com/project/codAaoxh) for a global config file and UI To manage settings, reset, or uninstall the pack, use `/trigger tschipcraft.menu` or `/function #tschipcraft:menu`. ## 🧩 Compatibility Supported Minecraft versions

**Forge** is only natively supported until Minecraft 1.21.5. This data pack follows the [Smithed](https://wiki.smithed.dev/conventions/) and essential [MC Datapacks Discord Server](https://mc-datapacks.github.io/en/conventions/index.html) Conventions to ensure data pack compatibility. ## 🔗 External Links

## 🤝 Partner Offer

datapack

Tectonic

Dynamic Lights