# Lumen \u2013 Advanced Lighting for Minecraft<\/p>\n
**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:<\/p>\n
– **Lumen Torch** \u2013 Automatically lights up the surroundings with custom light level.
\n– **Lumen Guard** \u2013 Prevents hostile mobs from spawning.<\/p>\n
> \ud83d\udca1**Attention:** NO resource pack needed! Built exclusively for **PaperMC**.<\/p>\n
 <\/p>\n
<\/p>\n
—<\/p>\n
## \u26a1\ufe0f Features<\/p>\n
– **Smart Lighting Optimization:** Automatically skips redundant light blocks based on light intensity, reducing block count while maintaining perfect illumination.
\n– **Placement Safety:** Intelligently avoids placing lights near sensitive blocks (saplings, redstone mechanisms, etc.) with a configurable safety margin.
\n– **Dynamic lighting** using **commands** and **custom crafteable items** (No resource pack needed).
\n– **Auto-lighting** torches with custom light level (Lumen Torch).
\n– Mob spawn prevention (Lumen Guard).
\n– **Integration** with **CoreProtect & FAWE**. (Recommended)
\n– **Multilingual Support** \u2013 Available translations: **Spanish**, **Chinese**, **English**, **French**, **German**, **Italian** and **Brazilian Portuguese**.<\/p>\n
—<\/p>\n
## Usage<\/p>\n
### For Players
\n– The `Lumen Torch` automatically lights up nearby areas.
\n – Players can right-click the air while holding a Lumen Torch and input a light level between 0 and 15 in the chat.
\n – The selected light level will be stored in the torch and applied when placed.
\n– The `Lumen Guard` prevents mob spawning within its range.
\n– Torches can be removed without being lost, and their effects disappear when removed.
\n– To craft them, you need `lumen.craft.torch` and `lumen.craft.guard` permissions.<\/p>\n
**Crafting Recipes**<\/p>\n <\/p>\n<\/details>\n <\/p>\n<\/details>\n <\/p>\n —<\/p>\n ## \ud83d\udee0\ufe0f Compatible Integrations<\/p>\n Lumen can leverage other tools to enhance performance and functionality:<\/p>\n – **CoreProtect** \u2013 Logs light placements and removals, allowing rollbacks and audits. —<\/p>\n ## \ud83d\udd10 Commands & Permissions<\/p>\n Lumen also provides a variety of aliases for each command `\/lumen`, `\/lu`, and `\/l`.<\/p>\n – `\/lumen light – **OP Permissions:** —<\/p>\n ### For Administrators —<\/p>\n ## \ud83d\udccc Installation Guide<\/p>\n ## **Prerequisites** – **Minecraft Server:** **PaperMC 1.21.1 or higher**. —<\/p>\n ## **Step 1: Download the Plugin** —<\/p>\n ## **Step 2: Installation** —<\/p>\n ## **Step 3: Initial Configuration** ## \ud83d\udcac Support & Contact<\/p>\n If you have any questions or encounter issues, feel free to contact us on Discord<\/p>\n","protected":false},"excerpt":{"rendered":" Effortless world lighting with torches and commands and optimized performance<\/p>\n","protected":false},"featured_media":96393,"template":"","meta":{"_minecraft_slug":"lumen","_minecraft_project_id":"izTZx6gw","_minecraft_author":"stargaze","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":511,"_minecraft_follows":8,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"lumen.zip","_minecraft_size_bytes":2819108,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T10:29:52.493382Z","_minecraft_date_created":"2025-02-27T10:16:43.206927Z","_minecraft_date_modified":"2026-03-04T16:19:16.399664Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/lumen","_minecraft_icon_attachment_id":96393,"_minecraft_imported_at":"2026-06-05T12:33:22+00:00","_minecraft_import_hash":"e81fc65c806b10ce863784363fa51d13","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,89,137,90,127,128,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,41,73,74,38,78,79,80,81],"class_list":["post-96392","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-game-mechanics","mod_category-mobs","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\nLumen Torch<\/summary>\n
Lumen Guard<\/summary>\n
\n– **FastAsyncWorldEdit (FAWE)** \u2013 Optimizes light block placement through commands and the Lumen Torch, improving server performance.<\/p>\nCommands<\/summary>\n
\n– `\/lumen undo` \u2013 Undoes previous light placements.
\n– `\/lumen redo` \u2013 Redoes removed lights.
\n– `\/lumen remove area
\n– `\/lumen clear confirm` \u2013 Clears all registered lights.
\n– `\/lumen give
\n– `\/lumen reload` \u2013 Reloads configuration and translations.<\/p>\n<\/details>\nPermissions<\/summary>\n
\n – `lumen.light` \u2013 Permission to use `\/lumen light`.
\n – `lumen.cancel` \u2013 Permission to cancel active tasks.
\n – `lumen.undo` \u2013 Permission to undo placements.
\n – `lumen.redo` \u2013 Permission to redo removed lights.
\n – `lumen.remove` \u2013 Permission to remove lights.
\n – `lumen.clear` \u2013 Permission to clear all lights.
\n – `lumen.give` \u2013 Permission to give `Lumen Torch` and `Lumen Guard`.
\n – `lumen.reload` \u2013 Permission to reload configuration and translations.
\n– **PLAYER Permissions:**
\n – `lumen.craft.*` \u2013 Permission to craft all Lumen items.
\n – `lumen.craft.torch` \u2013 Permission to craft the `Lumen Torch`.
\n – `lumen.craft.guard` \u2013 Permission to craft the `Lumen Guard`.<\/p>\n<\/details>\n
\n– **Smart Spacing:** Control the density of light blocks with `spacing_factor`.
\n– **Safety Settings:** Customize which blocks to avoid and the safety margin radius.
\n– Advanced light management using commands.
\n– Safe light removal with `\/lumen remove`.
\n– Undo and redo light placements with `\/lumen undo` and `\/lumen redo`.
\n– Clear all lights with `\/lumen clear` (Dangerous).
\n– Item distribution using `\/lumen give`.
\n– Full customization through `config.yml` and translation files in `Translations\/`.
\n– Integration with CoreProtect and FAWE for enhanced performance and control.
\n– Reload configuration and translations with `\/lumen reload`.<\/p>\nInstallation<\/summary>\n
\nBefore installing Lumen, make sure your server meets the following requirements:<\/p>\n
\n– **Java:** Version **21 or higher**.
\n– **Optional Dependencies:**
\n – **CoreProtect (Optional):** Enables tracking and rollback of placed or removed lights.
\n – **FastAsyncWorldEdit (Optional):** Optimizes performance for placing large amounts of lights.<\/p>\n
\nDownload the latest version of **Lumen** from Modrinth.<\/p>\n
\n1. **Upload the file** `Lumen.jar` to the `plugins\/` folder of your PaperMC server.
\n2. **Restart the server** to automatically generate the configuration files.<\/p>\n
\n1. **Navigate to the configuration folder:** `plugins\/Lumen\/`
\n2. **Edit `config.yml`** to adjust performance and safety settings:
\n – `smart_lighting.spacing_factor`: Control how many blocks are skipped during lighting.
\n – `safety.margin`: Radius of blocks to avoid around sensitive materials.
\n – `safety.excluded_blocks`: List of materials to avoid (saplings, redstone, etc.).
\n – `command_lights_per_tick`: Lights per tick when using commands.
\n3. **If using CoreProtect\/FAWE,** check the server console on startup for successful detection.<\/p>\n<\/details>\n