An open API service indexing awesome lists of open source software.

https://github.com/xcykrix/dynamiclights

[Spigot/Stable] Dynamic Lights for Minecraft Servers without requiring Modding.
https://github.com/xcykrix/dynamiclights

Last synced: 5 months ago
JSON representation

[Spigot/Stable] Dynamic Lights for Minecraft Servers without requiring Modding.

Awesome Lists containing this project

README

          

# 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](https://minecraft.fandom.com/wiki/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 and on worn items.

#### Lights flickers in Blocks like Tall Grass, Sea Grass, and Kelp. Why?

DynamicLights utilizes the
[Light Block](https://minecraft.fandom.com/wiki/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