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
- Download the JAR
- Put it in
/plugins
- Start the server
- Edit
config.yml if needed
- 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