Lumen

# Lumen – 高级照明 Minecraft 插件 **Lumen** 是一个 **Minecraft** 插件，旨在通过优化照明来提升服务器的质量。 它允许使用命令进行高效的区域照明，并提供独特的物品： - **发光火把 (Lumen Torch)** – 自动照亮周围环境，具有自定义亮度级别。 - **发光护卫 (Lumen Guard)** – 防止敌对生物生成。 > 💡**注意：** 不需资源包！ [](https://erosmari.com/discord)   --- ## ⚡️ 功能 - 使用 **命令** 和 **可自定义合成物品** 的 **动态照明** (无需资源包)。 - 自动照亮带有自定义光照级别的火把 (Lumen Torch)。 - 阻止生物生成 (Lumen Guard)。 - 与 **CoreProtect & FAWE** 集成。（推荐） - **多语言支持** – 可用翻译：**西班牙语**、**中文**、**英语**、**法语**、**德语**、**意大利语**和 **巴西葡萄牙语**。 可以添加自定义语言。 --- ## 使用方法 ### 对于玩家 - `Lumen Torch` 自动照亮附近的区域。 - 玩家可以在拿着发光火把的情况下对着空气右键单击并输入 0 到 15 之间的光照等级。 - 所选的光照等级将存储在火把中并在放置时应用。 - `Lumen Guard` 阻止生物在其范围内生成。 - 火把可以被移除而不会丢失，并且在移除时其效果会消失。 - 要制作它们，您需要 `lumen.craft.torch` 和 `lumen.craft.guard` 权限。 **合成配方**

发光火把 (Lumen Torch)


发光护卫 (Lumen Guard)


 --- ## 🛠️ 兼容集成 Lumen 可以利用其他工具来增强性能和功能： - **CoreProtect** – 记录光线放置和移除，允许回滚和审计。 - **FastAsyncWorldEdit (FAWE)** – 通过命令和 Lumen Torch 优化光块放置，提高服务器性能。   这些集成是可选的，但为了获得更好的控制和效率而推荐。 --- ## 🔐 命令 & 权限

命令

Lumen 还提供每个命令的各种别名 `/lumen`、`/lu` 和 `/l`。 - `/lumen light ` – 动态放置光线。 - `/lumen undo` – 撤销之前的放置。 - `/lumen redo` – 重做移除的光线。 - `/lumen remove area ` – 移除指定区域的光线。 - `/lumen clear confirm` – 清除所有注册的光线。 - `/lumen give ` – 将火把给玩家。 - `/lumen reload` – 重新加载配置和翻译。

权限

- **OP 权限：** - `lumen.light` – 使用 `/lumen light` 的权限。 - `lumen.cancel` – 权限取消活动任务。 - `lumen.undo` – 撤销放置的权限。 - `lumen.redo` – 重做移除的光线的权限。 - `lumen.remove` – 移除光线的权限。 - `lumen.clear` – 清除所有光线的权限。 - `lumen.give` – 将 `Lumen Torch` 和 `Lumen Guard` 给予玩家的权限。 - `lumen.reload` – 重新加载配置和翻译的权限。 - **玩家权限：** - `lumen.craft.*` – 合成所有 Lumen 物品的权限。 - `lumen.craft.torch` – 合成 `Lumen Torch` 的权限。 - `lumen.craft.guard` – 合成 `Lumen Guard` 的权限。

--- ### 对于管理员 - 使用命令进行高级光线管理。 - 使用 `/lumen remove` 安全移除光线。 - 使用 `/lumen undo` 和 `/lumen redo` 撤销重做光线放置。 - 使用 `/lumen clear` 清除所有光线（危险）。 - 使用 `/lumen give` 分发物品。 - 通过 `config.yml` 和 `Translations/` 目录中的翻译文件进行完全自定义。 - 与 CoreProtect 和 FAWE 集成以增强性能和控制。 - 使用 `/lumen lang` 更改插件语言。 - 使用 `/lumen reload` 重新加载配置和翻译。 - 在 `config.yml` 中调整性能设置：控制每个滴中放置的光线数量和火把滴的时间间隔。 - 控制每个命令和物品的权限。 --- ## 📌 安装指南

安装

## **先决条件** 在安装 Lumen 之前，请确保您的服务器满足以下要求： - **Minecraft 服务器：** PaperMC **1.21 或更高版本**（推荐 **1.21.4**，最新稳定版本）。 - **Java：** 版本 **21 或更高版本**。 - **可选依赖项：** - **CoreProtect (可选)：** 启用对放置或移除的光线的跟踪和回滚。服务器启动时可以在控制台中验证集成。 - **FastAsyncWorldEdit (可选)：** 优化放置和移除大量光块的性能。 --- ## **步骤 1：下载插件** 从 [Modrinth](https://modrinth.com/plugin/lumen) 下载 **Lumen** 的最新版本，并确保您获得一个有效的 `.jar` 文件。 --- ## **步骤 2：安装** 1. **上传文件** `Lumen.jar` 到您的 PaperMC 服务器的 `plugins/` 文件夹。 2. **重新启动服务器** 以自动生成配置文件。 3. **通过检查控制台来验证安装**。 如果安装成功，您将看到一条消息指示插件已正确加载。 --- ## **步骤 3：初始配置** 1. **导航到配置文件夹：** `plugins/Lumen/` 2. **编辑 `config.yml`** 以调整性能设置，例如： - `command_lights_per_tick`: 使用命令时每个滴中添加的光线数量。 - `torch_lights_per_tick`: 使用火把时每个滴中添加的光线数量。 - `torch_tick_interval`: 火把滴的时间间隔。 - `mob_torch_radius`: 护卫火把的反制半径。 3. **如果使用 CoreProtect，** 启动服务器时请检查控制台。 如果集成成功，您将看到一条消息指示已检测到 CoreProtect 并且在 Lumen 中处于活动状态。 4. **如果使用 FastAsyncWorldEdit，** 确保已安装并正确配置以优化光块的放置和移除。 --- ## **步骤 4：故障排除** - **插件无法加载：** 建议使用 **PaperMC 1.21.4**，最新稳定版本。 另外，请确保您使用的是 Java 21 或更高版本。 - **CoreProtect 错误：** 启动服务器时请检查控制台。 如果集成未激活，请确保 CoreProtect 已正确安装。 - **放置光线时性能低：** 调整 `config.yml` 中的值和/或安装 **FastAsyncWorldEdit** 以优化大规模块处理。 - 仅新建放置的 `Lumen Torch` 和 `Lumen Guard` 会受到 config.yml 中更改的影响。 之前放置的火把将不受影响，除非它们被移除并重新放置。

## 💬 支持 & 联系 如果您有任何问题或遇到任何问题，请随时在 [Discord](https://erosmari.com/discord) 上联系我们。