Death Bans

[!(https://img.shields.io/discord/1480618281189773314?label=Discord&logo=discord&logoColor=white&color=5865F2)](https://discord.gg/qdmSv7usbJ) [!(https://img.shields.io/badge/GitHub-DeathBan-181717?logo=github)](https://github.com/vanillaxtra/DeathBan) [!(https://img.shields.io/badge/Minecraft-1. 13--1. 21.x-62B47A)](https://github.com/vanillaxtra/DeathBan) [!(https://img.shields.io/badge/Folia-Supported-blue)](https://github.com/vanillaxtra/DeathBan)

# ☠️ DeathBan

> The hardcore death-ban plugin, rebuilt for the modern era.

DeathBan temporarily — or permanently — bans players when they run out of lives. One death doesn't end it all; players get a configurable number of chances before they're locked out. Whether you're running a hardcore SMP, a UHC event, or a custom punishment system, DeathBan has you covered.

## ✨ Features

• 💀 Lives system — Players have a configurable number of lives before a death-ban kicks in
• ⏱️ Timed & permanent bans — Set ban durations per group, or use `permanent` to lock players out forever
• 📈 Escalating bans — Configure a list of ban times that increase with each ban (10m → 1h → permanent)
• 👥 Permission groups — Different lives and ban durations for different ranks (VIP, Staff, etc.)
• 📢 Server-wide announcements — Optional broadcast when a player is banned, fully customisable
• 🎨 Fully customisable messages — Every message the plugin sends can be edited in `config.yml`
• 🔄 Live hot-reload — `/deathban reload` reloads all config, messages, and groups instantly — no restart required
• 🎯 PlaceholderAPI support — Expose lives and ban stats to scoreboards, tab lists, and chat plugins
• ⚔️ Revive system — Players can sacrifice one of their own lives to unban another player
• 🛡️ Vanilla ban list integration — Optionally sync bans to `/banlist` so they persist even without the plugin
• 🌿 Folia native support — Region-aware scheduling, works on threaded Folia servers out of the box
• 📦 Single JAR — One file runs on Bukkit, Spigot, Paper, Purpur, and Folia across all versions 1. 13–1. 21.x

## 🖥️ Platform Support

| Platform | Supported | |----------|-----------| | Bukkit | ✅ | | Spigot | ✅ | | Paper | ✅ | | Purpur | ✅ | | Folia | ✅ |

> Runs on a single JAR — no separate builds for different platforms.

## 🎨 Fully Customisable Messages

Every single piece of text the plugin sends to players can be changed in `config.yml`. No hardcoded strings anywhere.

### Kick Screen

When a player runs out of lives and is banned, they see a fully customisable kick screen:

!(images/kick-screen.png)

This message is completely up to you. Change the wording, add color codes, make it dramatic — it's all in your config:

```yaml messages: kick: |- You died and have been banned. You will be unbanned in %time%. kick-permanent: |- You died and have been permanently banned. ```

The same message also appears on the login screen if a banned player tries to rejoin (`messages.ban` and `messages.ban-permanent`).

### Server Announcement

You can optionally broadcast a message to all online players when someone gets banned. This is turned off by default — enable it and customise the message whenever you're ready:

!(images/chat-announce.png)

```yaml # Off by default. Set to true to enable. announce-ban: false

messages: announce: '%player% was banned for %time%' announce-permanent: '%player% was permanently banned' ```

When enabled, the announce message supports all the usual placeholders (`%player%`, `%time%`, `%lives%`, `%bans%`, etc.) and `&` color codes.

## 📋 Commands

| Command | Description | Permission | |---------|-------------|------------| | `/lives` | Check your own remaining lives | `deathban.command.lives` | | `/lives ` | Check another player's lives | `deathban.command.lives` | | `/revive ` | Transfer one of your lives to a banned player | `deathban.command.revive` | | `/deathban reset ` | Remove a ban and restore full lives | `deathban.command.admin` | | `/deathban set ` | Set a player's exact life count | `deathban.command.admin` | | `/deathban add ` | Add lives to a player | `deathban.command.admin` | | `/deathban ban ` | Manually ban a player for a duration | `deathban.command.admin` | | `/deathban reload` | Hot-reload all config and messages | `deathban.command.admin` |

## 🔑 Permissions

| Permission | Default | Description | |------------|---------|-------------| | `deathban.` | false | All DeathBan permissions | | `deathban.bypass` | false | Never get death-banned | | `deathban.command.` | op | All commands | | `deathban.command.lives` | true | Use `/lives` | | `deathban.command.revive` | true | Use `/revive` | | `d