Darkness-Health

## DarknessHealth **DarknessHealth** is a lightweight mini-game plugin for Minecraft **1.20+** that introduces a unique survival twist: the darker it gets around the player, the lower their maximum health becomes. Use it to create horror events, survival challenges, adventure maps, or custom mini-games where darkness is a real threat. <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/MlVe_LopAjI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> --- ## ✨ Features * Dynamic max-health reduction based on block light level * Fully configurable worlds and options * Supports **Survival** and **Adventure** modes * Optional **instant death** at light level 0 * Automatic health restoration when returning to light * Subtle sound cue when light level decreases * Lightweight and optimized for production servers * Perfect for mini-games, events, and unique gameplay modes --- ## 🔧 Configuration ```yaml config: enabled: true deathindarkness: false enabled_worlds: - world - world_nether - world_the_end ``` ### Config Details | Key | Description | | ----------------- | ------------------------------------- | | `enabled` | Toggles the mechanic on/off | | `deathindarkness` | Kill players instantly when light = 0 | | `enabled_worlds` | Worlds where DarknessHealth is active | --- ## 📝 How It Works * Every 10 ticks, the plugin checks the player’s light level. * Light level < 10 → max health decreases proportionally. * Full darkness (0) → either 1 HP or instant death (configurable). * Health resets automatically once the player steps into light. * Does **not** affect Creative or Spectator players. --- ## 📦 Installation 1. Download the JAR 2. Put it in `/plugins` 3. Start the server 4. Edit `config.yml` if needed 5. Reload the plugin or restart --- ## 🧩 Compatibility * **Minecraft:** 1.20+ * **Platforms:** Paper, Spigot * Works with datapacks and custom world generators * Fully compatible with most health-related plugins ---