▶️ ЗАБЕРИ СВОИ 8 ПОДАРКОВ 🎁 ПРИ СОЗДАНИИ СВОЕГО МАЙНКРАФТ СЕРВЕРА
Моды/Death Bans
Death Bans

Death Bans

A simple, modern plugin to ban players on their death.

26
0

Discord GitHub Minecraft Folia


☠️ 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

PlatformSupported
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:

Kick screen showing "You died and have been banned. You will be unbanned in 10 hours."

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

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:

Chat showing "notauthorised left the game"

# 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

CommandDescriptionPermission
/livesCheck your own remaining livesdeathban.command.lives
/lives <player>Check another player's livesdeathban.command.lives
/revive <player>Transfer one of your lives to a banned playerdeathban.command.revive
/deathban reset <player>Remove a ban and restore full livesdeathban.command.admin
/deathban set <player> <lives>Set a player's exact life countdeathban.command.admin
/deathban add <player> <lives>Add lives to a playerdeathban.command.admin
/deathban ban <player> <time>Manually ban a player for a durationdeathban.command.admin
/deathban reloadHot-reload all config and messagesdeathban.command.admin

🔑 Permissions

PermissionDefaultDescription
deathban.*falseAll DeathBan permissions
deathban.bypassfalseNever get death-banned
deathban.command.*opAll commands
deathban.command.livestrueUse /lives
deathban.command.revivetrueUse /revive
deathban.command.adminopAll admin sub-commands
deathban.notifyopReceive update notifications on join

📊 PlaceholderAPI

Requires PlaceholderAPI to be installed.

PlaceholderDescriptionExample Output
%deathban_lives%Lives remaining before next ban7
%deathban_max_lives%Maximum lives for this player's group10
%deathban_deaths%Deaths since last ban3
%deathban_bans%Total number of times this player has been banned2

Use these in any PAPI-compatible plugin — scoreboards, tab lists, chat, holograms, etc.


⚙️ Configuration

Time Format

Control how ban durations are displayed to players. Multiple styles available:

# Relative countdown (default) — "10 hours", "45 minutes"
time-format: 'in 1 hours minutes? seconds?'

# Absolute date — "10 March 2026 at 17:45:00"
time-format: 'date-format long long'

# Compact — "3h 45m"
time-format: 'in 3 hours minutes? seconds?'

# Custom pattern
time-format: 'custom-date-format dd-MM-yyyy HH:mm:ss'

Lives & Ban Duration

default:
  lives: 10          # Deaths before a ban triggers
  time: 10h          # Ban duration (s, m, h, d, w supported)
  # time: permanent  # Never-expiring ban

Escalating bans — each entry applies to the nth ban, and once the list runs out, all future bans are permanent:

default:
  lives: 10
  time:
    - 10m       # First ban: 10 minutes
    - 1h        # Second ban: 1 hour
    - 12h       # Third ban: 12 hours
    - permanent # Fourth ban and beyond: permanent

Permission Groups

Give different ranks their own lives and ban times. The highest-priority matching group wins:

groups:
  vip:
    permission: deathban.group.vip
    lives: 15
    time: 2h
    priority: 1

  staff:
    permission: deathban.group.staff
    lives: 20
    time: 30m
    priority: 2

Messages

Every message supports & color codes and the following placeholders:

PlaceholderDescription
%player%Player's name
%time%Ban duration (formatted by time-format)
%lives%Lives remaining
%maxlives%Maximum lives
%deaths%Current death count
%bans%Total ban count
messages:
  # Shown on the login screen when the player tries to reconnect while banned
  ban: |-
    You were banned because of your death.
    You will be unbanned in %time%.
  ban-permanent: |-
    You were permanently banned because of your death.

  # Shown as the instant kick when the ban is applied
  kick: |-
    You died and have been banned.
    You will be unbanned in %time%.
  kick-permanent: |-
    You died and have been permanently banned.

  # Optional server-wide broadcast (requires announce-ban: true)
  announce: '%player% was banned for %time%'
  announce-permanent: '%player% was permanently banned'

Ban Announcements

Off by default. Enable and customise whenever you like — just set announce-ban: true and edit the message:

announce-ban: false   # Change to true to enable

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

Revive System

Players can sacrifice one of their own lives to unban another player with /revive <player>. A confirmation prompt prevents accidental self-banning:

revive-confirm: 10    # Seconds to confirm if the revive would ban the sender (0 = no confirm)
revive-lives: all     # Lives the revived player gets back (all / positive / negative)

revive-lives examples:

  • all — full lives restored
  • 3 — exactly 3 lives
  • -2 — max lives minus 2

Vanilla Ban List Integration

use-vanilla-bans: false

When true, DeathBan syncs every ban to the server's built-in /banlist. Banned players are blocked at the server level even if DeathBan is removed. Bans are automatically pardoned when reset or revived.


Commands on Ban

Run custom commands automatically when a player is banned — integrate with any external plugin:

default:
  lives: 10
  time: 10h
  commands:
    - 'broadcast %player% has been death banned!'
    - 'lp user %player% parent set banned'

🔄 Hot Reload

All messages, groups, ban times, and settings are reloaded instantly with one command — no server restart needed:

/deathban reload

Any missing config keys are automatically restored from defaults on every reload.


📖 Credits

Originally created by Okx. This fork modernizes the plugin with Folia support, permanent bans, server-wide announcements, vanilla ban list integration, and full compatibility across all server platforms from 1.13 to 1.21.x.

Join the community: discord.gg/qdmSv7usbJ


📊 bStats

bStats: servers using death-bans

Совместимость

Minecraft: Java Edition

1.21.x1.20.x1.19.x1.18.x1.17.x1.16.x1.15.x1.14.x1.13.x

Поддерживаемые окружения

Сервер

Детали

Лицензия:GPL-3.0-only
Опубликован:1 месяц назад
Обновлён:3 недели назад
Главная