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 <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.

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.

---

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.

1. 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