Lumen is a Minecraft plugin that enhances lighting in Paper servers, allowing for dynamic light placement and mob prevention using special items.
Key features:
-
Dynamic lighting using commands and custom crafteable items (No resource pack needed).
-
Auto-lighting torches (Lumen Torch).
-
Mob spawn prevention (Lumen Guard).
-
Integration with CoreProtect & FAWE. (Recommended)
-
Multilingual support & customization options.
Illuminate & Protect – Unique Lumen Items (No resource pack needed)
- Lumen Torch: Light up surroundings automatically with customizable light levels.
- Players can right-click the air while holding a Lumen Torch and input a light level between 0 and 15.
- The selected light level will be stored in the torch and applied when placed.
- Permission: lumen.craft.torch
- Lumen Guard: Prevents hostile mobs from spawning.
-
- Permission: lumen.craft.guard
-
Lumen is designed to work flawlessly with other plugins to provide a smooth, efficient, and fully customizable lighting experience.
-
⚡ FastAsyncWorldEdit (FAWE) – Performance Boost
- Optimizes light placements, reducing lag on smaller and big servers
- Increases performance when placing large-scale lights
- Works great with
/lumen light
and the Lumen Torch - Extremely fast light placements
-
🔍 CoreProtect – Track & Rollback Light Placements and Removals
- ✅ Automatic & Smart Lighting – No need to place torches manually.
- 🔥 Performance-Friendly – No lag, optimized for Paper servers.
- 🛡️ Safe Gameplay – No more mob surprises near your builds.
- 🛠️ Customizable – Adjust settings in
config.yml
.
🌍 Lumen is for Everyone! (Multilingual Support)
Add custom translations or switch between built-in languages.
🔑 Commands and Permissions
/lumen light <range> <light_level> <include_skylight>
- lumen.light – Places lights dynamically
/lumen undo
- lumen.undo – Undoes previous light placements.
/lumen redo
- lumen.redo – Redoes removed lights.
/lumen remove area <range>
- lumen.remove – Removes lights in a specified area.
/lumen clear confirm
- lumen.clear – Clears all registered lights.
/lumen give <player/all> <torch_type> <quantity>
- lumen.give – Gives torches to players.
/lumen reload
- lumen.reload – Reloads configuration and translations.
/lumen lang <language>
- lumen.lang – Changes the plugin language.
Before installing Lumen, make sure your server meets the following requirements:
- Minecraft Server: PaperMC 1.21 or higher (recommended 1.21.4, the latest stable version).
- Java: Version 21 or higher.
- Internet connection: Required to verify the license.
- Optional Dependencies:
- CoreProtect (Optional): Enables tracking and rollback of placed or removed lights. Integration can be verified in the console upon server startup.
- FastAsyncWorldEdit (Optional): Optimizes performance for placing and removing large amounts of lights.
Download the latest version of Lumen from Polymart and ensure you obtain a valid .jar
file.
- Upload the file
Lumen.jar
to theplugins/
folder of your PaperMC server. - Restart the server to automatically generate the configuration files.
- Verify installation by checking the console. If the installation was successful, you will see a message indicating that the plugin has been loaded correctly.
- Navigate to the configuration folder:
plugins/Lumen/
- Edit
config.yml
to adjust performance settings, such as:command_lights_per_tick
: Number of lights added per tick when using commands.torch_lights_per_tick
: Number of lights added per tick when using torches.torch_tick_interval
: Interval between torch ticks.mob_torch_radius
: Protection radius of the anti-mob torch.
- If using CoreProtect, check the server console on startup. If integration is successful, you will see a message indicating that CoreProtect has been detected and is active in Lumen.
- If using FastAsyncWorldEdit, ensure it is installed and properly configured to optimize the placement and removal of lights.
Lumen requires an internet connection to verify the purchase via the Polymart API. If your server does not have internet access, the plugin will not work.
To avoid issues:
- Ensure the server can make outgoing HTTP requests.
- Do not block connections to
api.polymart.org
in your firewall.
- The plugin does not load: It is recommended to use PaperMC 1.21.4, the latest stable version. Also, ensure you are using Java 21 or higher.
- License verification failed: Confirm that the server has internet access and check the console for error messages.
- CoreProtect errors: Check the console when starting the server. If integration does not activate, ensure CoreProtect is correctly installed.
- Low performance when placing lights: Adjust values in
config.yml
and/or install FastAsyncWorldEdit to optimize large-scale block processing. - Only newly placed
Lumen Torch
andLumen Guard
will have effects of changes in config.yml. Previously placed torches will not be affected unless removed and placed again.
If you encounter issues or have questions, contact support on Discord or refer to the official plugin documentation.