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.

---

✨ 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

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

---