About DynamicLights
From SpigotMCEmit Light from Held Items using the 1.17 Light Blocks.
DynamicLights
Emit Light from Held and Worn Items using the 1.17 Light Blocks in Spigot/Paper Servers.
Current Support: 1.17.x to 1.21.x. You may need to use an older version for 1.17-1.19.4 era of servers at this time. v2.0.0 may not be compatible due to API changes that have not yet been overcome.
Please Note: Due to changes in CommandAPI, there are two separate versions of DynamicLights. Please ensure you select the version supported for your server.
ProtocolLib is NO LONGER required for DynamicLights.
Builds: https://github.com/xCykrix/DynamicLights/releases/latest
Discord: https://discord.gg/RHJQFPgbke
Request a Feature or Report a Bug: https://github.com/xCykrix/DynamicLights/issues
Usage/Examples
Commands
- /dynamiclights lock (dynamiclights.lock)
- Prevents placing Lanterns and Torches from the offhand. Useful for held lights while exploring or eating.
- /dynamiclights toggle (dynamiclights.toggle)
- Toggle the rendering of lights for your client to reduce client impact.
- /dynamiclights reload (dynamiclights.reload)
- Dynamically reload the "lights.yml" configuration to add or adjust light levels.
- "config.yml" changes require a restart due to async tasks at this time.
- Dynamically reload the "lights.yml" configuration to add or adjust light levels.
How does this plugin work?
DynamicLights works by creating a thread for each player and rendering a Light Block at their head location for all online players asynchronously.
At the player's head location, DynamicLights will send a block change packet to all players within the culling range. DynamicLights does NOT modify the world.
Can I change which items glow and work underwater?
Yes! In the "lights.yml" file you can add any item from https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html exactly as it appears to set custom light levels. You can also make them work underwater!
Lights flickers in Blocks like Tall Grass, Sea Grass, and Kelp. Why?
DynamicLights utilizes the Light Block to render the light in the world for all players. As this is an actual block, it requires there to be open air or open water to be used and cannot be placed on transparent blocks or blocks without collision.
Highlights
From source dataGame versions
Supports 3 Minecraft versions, the newest being 1.21.
Loaders
Runs on Spigot and Paper.
Footprint
Rated a light load on a server.
DynamicLights on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Spigot, Paper
- Server load
- light
- Smallest plan we suggest
- Minecraft — 1.5 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 2.0.0-BETA1, released 2026-01-08
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 1.20 to 1.21 (3 versions) | 1.21 |
| Spigot | 1.20 to 1.21 (3 versions) | 1.21 |
From 10 recorded builds of DynamicLights.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 2.0.0-BETA1 | 2026-01-08 | 1.20 to 1.21 (3 versions) | Spigot, Paper |
| 1.3.0 | 2025-09-17 | n/a | Spigot, Paper |
| 1.3.0-MC1.19 | 2025-09-17 | n/a | Spigot, Paper |
| 1.2.3 | 2025-06-25 | n/a | Spigot, Paper |
| 1.2.2 | 2025-04-29 | n/a | Spigot, Paper |
| 1.2.1 | 2024-12-10 | n/a | Spigot, Paper |
Run DynamicLights on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogWeapons, items & crafting
New weapons, gear, items and the recipes to make them.
Runs on your server
From source side supportSpigotMC lists DynamicLights as required on the server. Check its SpigotMC page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- SpigotPaper
- Runs on
- Serverrequired on the server
- Game versions
- 1.21 and 2 earlier
- Requires
- One-click install needs a Paper server.
Verified at the source
- ✓SpigotMCOfficial listing, checked 2026-10-16Open ↗
- ✓AuthorxCykrix, as published on SpigotMC
- ✓LicenseNot published by the sourceFree










