\n
\n
\n<\/p>\n
—<\/p>\n
# \u2620\ufe0f DeathBan<\/p>\n
> **The hardcore death-ban plugin, rebuilt for the modern era.**<\/p>\n
DeathBan temporarily \u2014 or permanently \u2014 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.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \ud83d\udc80 **Lives system** \u2014 Players have a configurable number of lives before a death-ban kicks in
\n– \u23f1\ufe0f **Timed & permanent bans** \u2014 Set ban durations per group, or use `permanent` to lock players out forever
\n– \ud83d\udcc8 **Escalating bans** \u2014 Configure a list of ban times that increase with each ban (10m \u2192 1h \u2192 permanent)
\n– \ud83d\udc65 **Permission groups** \u2014 Different lives and ban durations for different ranks (VIP, Staff, etc.)
\n– \ud83d\udce2 **Server-wide announcements** \u2014 Optional broadcast when a player is banned, fully customisable
\n– \ud83c\udfa8 **Fully customisable messages** \u2014 Every message the plugin sends can be edited in `config.yml`
\n– \ud83d\udd04 **Live hot-reload** \u2014 `\/deathban reload` reloads all config, messages, and groups instantly \u2014 no restart required
\n– \ud83c\udfaf **PlaceholderAPI support** \u2014 Expose lives and ban stats to scoreboards, tab lists, and chat plugins
\n– \u2694\ufe0f **Revive system** \u2014 Players can sacrifice one of their own lives to unban another player
\n– \ud83d\udee1\ufe0f **Vanilla ban list integration** \u2014 Optionally sync bans to `\/banlist` so they persist even without the plugin
\n– \ud83c\udf3f **Folia native support** \u2014 Region-aware scheduling, works on threaded Folia servers out of the box
\n– \ud83d\udce6 **Single JAR** \u2014 One file runs on Bukkit, Spigot, Paper, Purpur, and Folia across all versions 1.13\u20131.21.x<\/p>\n
—<\/p>\n
## \ud83d\udda5\ufe0f Platform Support<\/p>\n
| Platform | Supported |
\n|———-|———–|
\n| Bukkit | \u2705 |
\n| Spigot | \u2705 |
\n| Paper | \u2705 |
\n| Purpur | \u2705 |
\n| Folia | \u2705 |<\/p>\n
> Runs on a single JAR \u2014 no separate builds for different platforms.<\/p>\n
—<\/p>\n
## \ud83c\udfa8 Fully Customisable Messages<\/p>\n
Every single piece of text the plugin sends to players can be changed in `config.yml`. No hardcoded strings anywhere.<\/p>\n
### Kick Screen<\/p>\n
When a player runs out of lives and is banned, they see a fully customisable kick screen:<\/p>\n
<\/p>\n
This message is completely up to you. Change the wording, add color codes, make it dramatic \u2014 it’s all in your config:<\/p>\n
“`yaml
\nmessages:
\n kick: |-
\n You died and have been banned.
\n You will be unbanned in %time%.
\n kick-permanent: |-
\n You died and have been permanently banned.
\n“`<\/p>\n
The same message also appears on the login screen if a banned player tries to rejoin (`messages.ban` and `messages.ban-permanent`).<\/p>\n
—<\/p>\n
### Server Announcement<\/p>\n
You can optionally broadcast a message to all online players when someone gets banned. **This is turned off by default** \u2014 enable it and customise the message whenever you’re ready:<\/p>\n
<\/p>\n
“`yaml
\n# Off by default. Set to true to enable.
\nannounce-ban: false<\/p>\n
messages:
\n announce: ‘%player% was banned for %time%’
\n announce-permanent: ‘%player% was permanently banned’
\n“`<\/p>\n
When enabled, the announce message supports all the usual placeholders (`%player%`, `%time%`, `%lives%`, `%bans%`, etc.) and `&` color codes.<\/p>\n
—<\/p>\n
## \ud83d\udccb Commands<\/p>\n
| Command | Description | Permission |
\n|———|————-|————|
\n| `\/lives` | Check your own remaining lives | `deathban.command.lives` |
\n| `\/lives
\n| `\/revive
\n| `\/deathban reset
\n| `\/deathban set
\n| `\/deathban add
\n| `\/deathban ban