Light Cleaner - 光照修复工具

Light Cleaner 是一款专注于修复和重新生成区块光照的插件。它通过专用线程和优化算法高效处理光照计算，显著减少对服务器性能的影响，并能自动清理新生成或由 WorldEdit 等插件修改区域的光照。

💡概述

Minecraft 中长久存在一个恼人的漏洞：新生成的区块内经常出现不自然的黑暗区域，例如洞穴、峡谷或下界。这些错误的光照不仅破坏了游戏世界的视觉美感，还会因客户端不断尝试修复而拖累性能。

Light Cleaner 可以彻底解决这个问题。它使用原版 Minecraft 的方块数据，从零开始重新计算光照等级，使一切看起来都符合预期。无论是修复玩家视野内的区域，还是整个世界的光照，它都能在独立线程中快速完成，避免阻塞主服务器线程。

✨功能特性

• 高性能处理：通过原始数据操作和智能缓存，能够以每秒约 200 个区块的速度重新生成光照。
• 多线程运行：所有计算在专用线程上完成，最大限度减少对服务器 TPS 的影响。
• 自动光照清理：支持自动清理新生成区块的光照，玩家探索时无需手动干预。
• 插件兼容修复：可在 WorldEdit / FastAsyncWorldEdit 快速修改方块后，修复受影响区域的光照。
• 内存与并发控制：提供配置项以平衡清理速度与服务器负载，防止内存溢出。
• 安全可靠：仅更新光照等级数据，不会写入或破坏任何方块信息。

🎮指令列表

使用 /cleanlight 及其子命令来管理光照修复：

• /cleanlight

-   重新生成玩家视野内所有区块的光照。

• /cleanlight <半径>

-   重新生成以玩家为中心、指定半径（区块数）的正方形区域内的光照。例如 `/cleanlight 12` 处理 25x25 的区块区域。

• /cleanlight world

-   重新生成当前玩家所在世界的所有区块光照。

• /cleanlight world <世界名>

-   重新生成指定世界的所有区块光照。

• /cleanlight abort

-   取消所有正在进行的光照修复操作。

• /cleanlight status

-   查看当前修复操作的状态。

• /cleanlight at [chunk_x] [chunk_z] [chunk_radius] (世界)

-   远程修复指定坐标和半径内的区块光照（适用于命令方块）。

🔧权限节点

通过以下权限控制玩家对指令的访问

• lightcleaner.clean.view

-   允许玩家修复其视野半径内的光照。

• lightcleaner.clean.any

-   允许玩家修复任意半径区域的光照（无视视野限制）。

• lightcleaner.clean.world

-   允许玩家修复整个世界的光照。

• lightcleaner.clean.radius.[半径]

-   允许玩家修复不超过指定半径的区域。例如 `lightcleaner.clean.radius.5` 允许使用半径 5 及以下的指令。

• lightcleaner.abort

-   允许玩家中止所有光照修复操作。

• lightcleaner.status

-   允许玩家查看修复操作状态。

⭐配置说明

编辑 config.yml 文件以自定义插件行为：

基础设置

• autoCleanEnabled: true

-   设置为 `true` 以启用对新生成区块的自动光照清理。

• autoCleanWorldEditEnabled: true

-   设置为 `true` 以在 WorldEdit / FastAsyncWorldEdit 操作后自动清理光照。

性能调整

• minFreeMemory: 400

-   当服务器剩余可用内存（MB）低于此值时，插件将暂停操作并保存世界以减少内存占用。若遇到内存不足错误，请提高此值；若觉得暂停过久，可降低此值。

• asyncLoadConcurrency: 50

-   插件处理时需要快速加载大量区块。此值控制并发加载的队列大小。高并发加载更快但可能影响性能，低并发则等待时间更长。若插件对服务器性能影响过大，请降低此值。

世界排除

• unsavedWorldNames:

-   在此列表中添加不持久化保存到磁盘的世界名称（例如 `- worldname1`）。插件将不会保存这些世界，并且在服务器重启后不会继续这些世界的光照修复操作。

❓与 FastAsyncWorldEdit (FAWE) 配合使用

FAWE 修改世界后可能出现光照错误。启用本插件的 autoCleanWorldEditEnabled 功能可自动修复。

重要提示：同时请务必在 FAWE 的 config.yml 中禁用其内置的重光照功能，以避免冲突：

lighting:
  delay-packet-sending: true
  async: true
  mode: 0 # 设置为 0（None）以禁用 FAWE 的重光照
  remove-first: false

💡重要须知

• 前置需求：本插件需要安装 BKCommonLib。
• 版本警告：切勿在 Minecraft 1.14 或更高版本的服务器上启用 autoCleanEnabled（自动清理新生成区块）。这不仅不再必要，还会导致服务器无视世界边界，无限生成边界外的区块。
• 性能影响：修复世界光照时，由于需要从磁盘加载和保存区块，可能导致 TPS 暂时下降。插件通过限制同时加载的区块数量来最小化此影响。
• 安全性：插件经过精心设计，只更新光照等级，绝不会写入或更改任何方块数据，保证了世界数据的安全。

🔧支持与捐赠

如需插件帮助，请加入我们的 Discord：https://discord.gg/wvU2rFgSnw

如果您非常喜欢我的工作并想给予一些回报，欢迎通过下方的链接进行小额捐赠。非常感谢！