DynamicLights - 动态光源

DynamicLights 是一款利用 Minecraft 1.17 版本引入的光源方块，为玩家手持或穿戴的物品添加动态光照效果的插件。它适用于 Spigot/Paper 服务端，通过异步线程为每位玩家渲染光照，且不会实际修改世界。

💡重要须知

• 版本支持：当前支持 1.17.x 至 1.21.x。对于 1.17 至 1.19.4 版本的服务端，您可能需要使用旧版插件。由于 API 变更，v2.0.0 版本可能不兼容。
• 版本选择：由于 CommandAPI 的改动，DynamicLights 有两个独立版本。请确保选择与您服务端兼容的版本。
• 依赖变更：ProtocolLib 不再是必需依赖。

🎮链接与支持

• 下载地址：https://github.com/xCykrix/DynamicLights/releases/latest
• Discord 社区：https://discord.gg/RHJQFPgbke
• 问题与建议：https://github.com/xCykrix/DynamicLights/issues

🔧使用方法与命令

以下是可用的命令及其权限节点。

命令列表

• /dynamiclights lock (dynamiclights.lock)

锁定副手，防止在探索或进食时从副手放置灯笼或火把。

• /dynamiclights toggle (dynamiclights.toggle)

切换客户端的光照渲染，以降低对客户端性能的影响。

• /dynamiclights reload (dynamiclights.reload)

动态重载 lights.yml 配置文件，以添加或调整物品的光照等级。

• 注意：对 config.yml 的修改目前需要重启服务器才能生效，因为涉及异步任务。

❓常见问题解答

插件如何工作？

DynamicLights 通过为每位在线玩家创建一个异步线程，在其头部位置为所有在线玩家渲染一个光源方块。它会向剔除范围内的所有玩家发送方块更新数据包，但不会修改世界本身。

我可以自定义哪些物品发光以及它们能否在水下工作吗？

可以！在 lights.yml 配置文件中，您可以添加来自 Minecraft 材料列表 的任何物品（需使用完全一致的名称）来设置自定义光照等级，并可以指定它们是否在水下工作。

为什么光照在高草、海草、海带等方块中会闪烁？

DynamicLights 使用光源方块在世界上为所有玩家渲染光照。由于这是一个实际的方块，它需要放置在空气或开放水域中，无法放置在透明方块或无碰撞箱的方块上，因此在这些特殊方块中会出现闪烁。