# 🌑 BloodMoon
*When the moon turns crimson, the night fights back — survive until dawn for your reward.*
## ✨ Overview
BloodMoon turns ordinary nights into harrowing survival events. On a configurable chance, a Blood Moon rises: hostile mobs spawn in greater numbers, hit harder, and shrug off more damage, while a blood-red sky and crimson particles set the mood. Players who survive until dawn are rewarded with experience and bonus health. Admins can trigger, stop, or check the status of a Blood Moon at any time.
## 📦 Installation
1. Drop `BloodMoon.jar` into your server's `/plugins` folder.
2. Restart the server.
3. Done! Built and tested against Minecraft **1.21** (api-version `1.21`).
## ⌨️ Commands
| Command | Description | Aliases | Permission |
|---------|-------------|---------|------------|
| `/bloodmoon` | Control the Blood Moon event. Usage: `/bloodmoon <start\|stop\|status>`. `start` forces a Blood Moon, `stop` ends it immediately, `status` reports whether one is active. | — | `bloodmoon.admin` |
## 🔑 Permissions
- **`bloodmoon.admin`** — Allows control of Blood Moon events. *(default: op)*
## ⚙️ Configuration
- **`bloodmoon.chance`** *(default: `0.05`)* — Probability per night-time check that a Blood Moon begins.
- **`bloodmoon.check-interval-minutes`** *(default: `2`)* — How often the plugin rolls to start a Blood Moon.
- **`bloodmoon.spawn-multiplier`** *(default: `3`)* — Multiplies natural hostile-mob spawns during the event.
- **`bloodmoon.health-multiplier`** *(default: `2.0`)* — Multiplies hostile-mob max health.
- **`bloodmoon.damage-multiplier`** *(default: `1.5`)* — Multiplies damage dealt by hostile mobs.
- **`bloodmoon.reward-experience`** *(default: `150`)* — XP granted to survivors.
- **`bloodmoon.reward-health`** *(default: `10`)* — Bonus health granted to survivors.
- **`bloodmoon.reward-message`** — Message shown to rewarded survivors.
- **`bloodmoon.broadcast-start`** / **`bloodmoon.broadcast-end`** *(default: `true`)* — Toggle server-wide announcements at the start and end of the event.
## 📖 Full documentation
---
🤖 *This plugin was created with **Spaleforce AI**. Create your own Minecraft plugins for free at* 🚀 **https://spaleforce.com**
