Lumen

Minecraft 版本： 1.21.11

平台： paper purpur

标签： game-mechanics optimization utility

Lumen – Advanced Lighting for Minecraft

Lumen is a Minecraft plugin designed to enhance server quality of life by optimizing lighting. It allows efficient area illumination using commands and offers unique items:

• Lumen Torch – Automatically lights up the surroundings with custom light level.
• Lumen Guard – Prevents hostile mobs from spawning.

?Attention: NO resource pack needed! Built exclusively for PaperMC.

---

⚡️ Features

• Smart Lighting Optimization: Automatically skips redundant light blocks based on light intensity, reducing block count while maintaining perfect illumination.
• Placement Safety: Intelligently avoids placing lights near sensitive blocks (saplings, redstone mechanisms, etc.) with a configurable safety margin.
• Dynamic lighting using commands and custom crafteable items (No resource pack needed).
• Auto-lighting torches with custom light level (Lumen Torch).
• Mob spawn prevention (Lumen Guard).
• Integration with CoreProtect & FAWE. (Recommended)
• Multilingual Support – Available translations: Spanish, Chinese, English, French, German, Italian and Brazilian Portuguese.

---

Usage

For Players

• The Lumen Torch automatically lights up nearby areas.
  • Players can right-click the air while holding a Lumen Torch and input a light level between 0 and 15 in the chat.
  • The selected light level will be stored in the torch and applied when placed.
• The Lumen Guard prevents mob spawning within its range.
• Torches can be removed without being lost, and their effects disappear when removed.
• To craft them, you need lumen.craft.torch and lumen.craft.guard permissions.

Crafting Recipes

Lumen Torch  Lumen Guard 

---

?️ Compatible Integrations

Lumen can leverage other tools to enhance performance and functionality:

• CoreProtect – Logs light placements and removals, allowing rollbacks and audits.
• FastAsyncWorldEdit (FAWE) – Optimizes light block placement through commands and the Lumen Torch, improving server performance.

---

? Commands & Permissions

Commands Lumen also provides a variety of aliases for each command `/lumen`, `/lu`, and `/l`. - `/lumen light ` – Places lights dynamically. - `/lumen undo` – Undoes previous light placements. - `/lumen redo` – Redoes removed lights. - `/lumen remove area ` – Removes lights in a specified area. - `/lumen clear confirm` – Clears all registered lights. - `/lumen give ` – Gives torches to players. - `/lumen reload` – Reloads configuration and translations. Permissions - **OP Permissions:** - `lumen.light` – Permission to use `/lumen light`. - `lumen.cancel` – Permission to cancel active tasks. - `lumen.undo` – Permission to undo placements. - `lumen.redo` – Permission to redo removed lights. - `lumen.remove` – Permission to remove lights. - `lumen.clear` – Permission to clear all lights. - `lumen.give` – Permission to give `Lumen Torch` and `Lumen Guard`. - `lumen.reload` – Permission to reload configuration and translations. - **PLAYER Permissions:** - `lumen.craft.*` – Permission to craft all Lumen items. - `lumen.craft.torch` – Permission to craft the `Lumen Torch`. - `lumen.craft.guard` – Permission to craft the `Lumen Guard`.

---

For Administrators

• Smart Spacing: Control the density of light blocks with spacing_factor.
• Safety Settings: Customize which blocks to avoid and the safety margin radius.
• Advanced light management using commands.
• Safe light removal with /lumen remove.
• Undo and redo light placements with /lumen undo and /lumen redo.
• Clear all lights with /lumen clear (Dangerous).
• Item distribution using /lumen give.
• Full customization through config.yml and translation files in Translations/.
• Integration with CoreProtect and FAWE for enhanced performance and control.
• Reload configuration and translations with /lumen reload.

---

? Installation Guide

Installation ## **Prerequisites** Before installing Lumen, make sure your server meets the following requirements: - **Minecraft Server:** **PaperMC 1.21.1 or higher**. - **Java:** Version **21 or higher**. - **Optional Dependencies:** - **CoreProtect (Optional):** Enables tracking and rollback of placed or removed lights. - **FastAsyncWorldEdit (Optional):** Optimizes performance for placing large amounts of lights. --- ## **Step 1: Download the Plugin** Download the latest version of **Lumen** from [Modrinth](https://modrinth.com/plugin/lumen). --- ## **Step 2: Installation** 1. **Upload the file** `Lumen.jar` to the `plugins/` folder of your PaperMC server. 2. **Restart the server** to automatically generate the configuration files. --- ## **Step 3: Initial Configuration** 1. **Navigate to the configuration folder:** `plugins/Lumen/` 2. **Edit `config.yml`** to adjust performance and safety settings: - `smart_lighting.spacing_factor`: Control how many blocks are skipped during lighting. - `safety.margin`: Radius of blocks to avoid around sensitive materials. - `safety.excluded_blocks`: List of materials to avoid (saplings, redstone, etc.). - `command_lights_per_tick`: Lights per tick when using commands. 3. **If using CoreProtect/FAWE,** check the server console on startup for successful detection.

? Support & Contact

If you have any questions or encounter issues, feel free to contact us on Discord