DynamicLights

Emit Light from Held Items using the 1.17 Light Blocks in Spigot/Paper Servers.

Discord: https://discord.gg/RHJQFPgbke

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 requires a restart due to async tasks at this time.

FAQ

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.

This plugin requires ProtocolLib to be present.

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 and on worn items.

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.

Deployment

This plugin is based on the PluginCommon API. Updates to SpigotDevkit will provide versioned and shaded assets associated with this plugin.

1. Update POM XML Plugins and Dependencies.
2. Update POM XML Version.
3. Build Plugin
4. Verify in 1.17 to 1.21.x (or current version)
5. Update GitHub Source Code
6. Tag Version to Last Commit
7. Add Release & Changelog
8. Update Spigot Release