Definitive DynamicLight 💡

Bring your server’s atmosphere to life without sacrificing performance. Definitive DynamicLight is the ultimate real-time dynamic lighting solution, built specifically for modern Minecraft servers.

Unlike old plugins that cause lag spikes and choke the main thread, this system was designed from the ground up with extreme optimization, smart asynchronous checks, and full multi-region support.

✨ Key Features

• ⚡ Zero-Lag Performance – Uses a BlockData caching layer to avoid thousands of heavy calls to the server core. Perfect for large communities.
• 🌍 Native Folia Support – Automatically detects Folia and schedules tasks with EntityScheduler and GlobalRegionScheduler for a true multi-threaded experience.
• 📊 Player-Count Presets – Adjusts behavior dynamically based on activity:
  • FANCY – Maximum visual fidelity, particles, and deep world scanning (1–80 players).
  • BALANCED – The sweet spot between immersion and performance (81–350 players).
  • PERFORMANCE – Aggressive resource saving for massive networks (+350 players).
  • CUSTOM – Full manual control over tick periods and delays.
• 📦 Item Illumination – Dropped items emit light too. Customize scan radius and tick stride to keep the world responsive.
• 🌊 Realistic Water Interaction – Torches and campfires extinguish underwater, lanterns stay lit, and light sources dim dynamically when submerged.
• 🎨 Custom Light Profiles – Set exact light levels (1–15) for any block or item with a simple, flexible config.
• 👥 Global Illumination Modes –
  • ALL – Everyone sees each other’s dynamic light trails.
  • PLAYER – Players only see their own lights, saving client performance.

🛠️ Configuration

Works perfectly out of the box, but you can tweak every detail:

dynamic_light:
  enabled: true
  global_illumination_mode: "ALL"
  preset: "FANCY"

  custom_light_levels:
    TORCH: 14
    LANTERN: 15
    CAMPFIRE: 15
    CRYING_OBSIDIAN: 10
    COPPER_LANTERN: 15

💻 Commands and Permissions

• /dl reload – Reload configuration and profiles.
• /dl toggle – Enable/Disable the module.
• /dl status – View module status.
• /dl help – Show this help menu.