lumen-banner.png

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.

effort.png

lightcommand.gif

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

craft.png

lumentorch.gif

Lumen is designed to work flawlessly with other plugins to provide a smooth, efficient, and fully customizable lighting experience.

integrations.gif

  • 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

why.png

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

lang.png

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

try.png

inst.png

Prerequisites

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.

Step 1: Download the Plugin

Download the latest version of Lumen from Polymart and ensure you obtain a valid .jar file.


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.
  3. Verify installation by checking the console. If the installation was successful, you will see a message indicating that the plugin has been loaded correctly.

Step 3: Initial Configuration

  1. Navigate to the configuration folder: plugins/Lumen/
  2. 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.
  3. 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.
  4. If using FastAsyncWorldEdit, ensure it is installed and properly configured to optimize the placement and removal of lights.

Step 4: License Verification

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.

Step 5: Troubleshooting

  • 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 and Lumen Guard will have effects of changes in config.yml. Previously placed torches will not be affected unless removed and placed again.

Support & Contact

If you encounter issues or have questions, contact support on Discord or refer to the official plugin documentation.

Lumen%20-%20Ultimate%20Lightning.svg