Darkness-Health

DarknessHealth

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

---

✨ Features

* Dynamic max-health reduction based on block light level * Fully configurable worlds and options * Supports instant death and instant death 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

* Platforms: 1.20+ * Platforms: Paper, Spigot * Works with datapacks and custom world generators * Fully compatible with most health-related plugins

---