Lumen

# 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**. (https://img.shields.io/discord/1369689692244803674?label=Discord&logo=discord&logoColor=white&color=31FFA3&style=for-the-badge)](https://soystargaze.com/discord) !(https://img.shields.io/badge/Made%20with-%E2%9D%A4%EF%B8%8F%20by%20stargaze-31FFA3?style=for-the-badge) !(https://cdn.modrinth.com/data/izTZx6gw/images/ed1c78a69e6aba737ccc687acc242140fcce6299.png) --- ## ⚡️ 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** <details> <summary>Lumen Torch</summary> !(https://cdn.modrinth.com/data/izTZx6gw/images/3b24b9cfe98580f238256d836aa834aa0eb637de.png) </details> <details> <summary>Lumen Guard</summary> !(https://cdn.modrinth.com/data/izTZx6gw/images/fcc06b4f5b13ef6a5db471241a713acd3b700195.png) </details> !(https://imgur.com/3OQtjzg.gif) --- ## 🛠️ 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 <details> <summary>Commands</summary> Lumen also provides a variety of aliases for each command `/lumen`, `/lu`, and `/l`. - `/lumen light <range> <light_level> <include_skylight>` – Places lights dynamically. - `/lumen undo` – Undoes previous light placements. - `/lumen redo` – Redoes removed lights. - `/lumen remove area <range>` – Removes lights in a specified area. - `/lumen clear confirm` – Clears all registered lights. - `/lumen give <player/all> <torch_type> <quantity>` – Gives torches to players. - `/lumen reload` – Reloads configuration and translations. </details> <details> <summary>Permissions</summary> - **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`. </details> --- ### 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 <details><summary>Installation</summary> ## **Prerequisit