Simple Deathban

☠️ DeathBan

DeathBan is a lightweight Minecraft plugin that automatically bans players when they die — perfect for hardcore events, UHC sessions, or any server where death should actually mean something.

---

🔥 What does it do?

When a player dies, they are automatically kicked and banned Permament. While banned, they see a clear message on the login screen telling them they died and must wait until an Admin unbans all Players.

---

✨ Features

- Persistent bans — Players are kicked after dying, then blocked from rejoining - Persistent bans — Banned players see a clear message explaining why they can't connect - Persistent bans — Protect specific players (like admins or event staff) from ever getting banned on death - Persistent bans — Instantly unban a specific player with one command - Persistent bans — Reset the entire event with a single `/deathban unbanall` — great for starting a new round - Persistent bans — Enable or disable the whole system at any time without restarting the server - Persistent bans — Bans survive server restarts.

---

🛠️ Commands

| Command | What it does | |---|---| | `/deathban toggle` | Turn the death ban system on or off | | `/deathban whitelist add <player>` | Protect a player from death bans | | `/deathban whitelist remove <player>` | Remove a player from the whitelist | | `/deathban unban <player>` | Manually unban one specific player | | `/deathban unbanall` | Instantly unban all currently banned players |

> All commands support tab completion, including auto-suggesting currently banned players for `/unban`.

---

🔒 Permissions

| Permission | Who needs it | |---|---| | `deathban.admin` | Required to use any `/deathban` command |

---

🛠️ Installation

1. Download `Deathban-1.0..jar` 2. Place it in your `plugins/` folder 3. Start the server

⚙️ Configuration

The plugin generates a simple `config.yml` on first launch. It stores the on/off state, the whitelist, and all active bans. You don't need to edit it manually — everything can be managed in-game.

---

💡 Perfect for...

- Tournaments — Run a weekend event where death means elimination - Tournaments — Add real stakes to every encounter - Tournaments — Give your season a hardcore twist without switching game modes - Tournaments — Automatically eliminate players who die, then reset the whole field for the next round with `unbanall`

---

📋 Requirements

- Minecraft Bukkit / Spigot / Paper - A Bukkit / Spigot / Paper server

---

📝 Notes

- The whitelist is UUID-based, so players can't bypass it by changing their username - No external dependencies — drop the `.jar` in and you're done