☠️ DeathBan
为现代时代重建的硬核死亡封禁插件。
当玩家生命值耗尽时,DeathBan 会暂时或永久地封禁他们。一次死亡并不意味着终结;在玩家被锁定之前,他们拥有可配置次数的机会。无论你是运行硬核生存服务器、UHC 活动还是自定义惩罚系统,DeathBan 都能满足你的需求。
✨ 功能
- ? 生命系统 — 玩家在触发死亡封禁前拥有可配置的生命次数
- ⏱️ 定时与永久封禁 — 可为不同组别设置封禁时长,或使用
permanent 将玩家永久锁定
- ? 递增式封禁 — 配置一系列随每次封禁而增加的封禁时间(10分钟 → 1小时 → 永久)
- ? 权限组 — 针对不同等级(如 VIP、Staff 等)设置不同的生命次数和封禁时长
- ? 全服公告 — 可选地在玩家被封禁时广播消息,支持完全自定义
- ? 完全自定义的消息 — 插件发送的所有消息均可在
config.yml 中编辑
- ? 实时热重载 —
/deathban reload 即时重新加载所有配置、消息和组别——无需重启服务器
- ? PlaceholderAPI 支持 — 向计分板、标签页列表和聊天插件暴露生命和封禁统计数据
- ⚔️ 复活系统 — 玩家可以牺牲自己的一条生命来解封另一名玩家
- ?️ 原版封禁列表集成 — 可选择将封禁同步到
/banlist,即使没有该插件也能持久保存
- ? 原生 Folia 支持 — 区域感知调度,开箱即用支持线程化的 Folia 服务器
- ? 单 JAR 文件 — 一个文件即可在 Bukkit、Spigot、Paper、Purpur 和 Folia 上运行,涵盖所有 1.13–1.21.x 版本
?️ 平台支持
| Platform |
Supported |
| Bukkit |
✅ |
| Spigot |
✅ |
| Paper |
✅ |
| Purpur |
✅ |
| Folia |
✅ |
运行于单个 JAR 文件——无需针对不同平台提供单独的构建版本。
? 完全自定义的消息
插件发送给玩家的每一条文本都可以在 config.yml 中进行更改。没有任何硬编码字符串。
踢出界面
当玩家生命值耗尽并被封禁时,他们会看到一个完全自定义的踢出界面:

这条消息完全由你决定。更改措辞、添加颜色代码、使其更具戏剧性——所有这些都在你的配置文件中:
messages:
kick: |-
You died and have been banned.
You will be unbanned in %time%.
kick-permanent: |-
You died and have been permanently banned.
如果被封禁的玩家尝试重新加入游戏,同样的消息也会出现在登录界面上(messages.ban 和 messages.ban-permanent)。
服务器公告
你可以选择在被封禁时将消息广播给所有在线玩家。默认情况下此功能已关闭——准备好后即可启用并自定义消息:

# 默认关闭。设置为 true 以启用。
announce-ban: false
messages:
announce: '%player% was banned for %time%'
announce-permanent: '%player% was permanently banned'
启用后,公告消息支持所有常用的占位符(%player%、%time%、%lives%、%bans% 等)以及 & 颜色代码。
? 命令
| Command |
Description |
Permission |
/lives |
查看自己剩余的生命次数 |
deathban.command.lives |
/lives <player> |
查看其他玩家的生命次数 |
deathban.command.lives |
/revive <player> |
将自己的一条生命转移给被封禁的玩家 |
deathban.command.revive |
/deathban reset <player> |
移除封禁并恢复全部生命 |
deathban.command.admin |
/deathban set <player> <lives> |
设置玩家的确切生命次数 |
deathban.command.admin |
/deathban add <player> <lives> |
为玩家增加生命次数 |
deathban.command.admin |
/deathban ban <player> <time> |
手动对玩家进行有时长的封禁 |
deathban.command.admin |
/deathban reload |
热重载所有配置和消息 |
deathban.command.admin |
? 权限
| Permission |
Default |
Description |
deathban.* |
false |
所有 DeathBan 权限 |
deathban.bypass |
false |
永远不会因死亡而被封禁 |
deathban.command.* |
op |
所有命令 |
deathban.command.lives |
true |
使用 /lives |
deathban.command.revive |
true |
使用 /revive |
deathban.command.admin |
op |
所有管理子命令 |
deathban.notify |
op |
加入时接收更新通知 |
? PlaceholderAPI
需要安装 PlaceholderAPI。
| Placeholder |
Description |
Example Output |
%deathban_lives% |
下次封禁前剩余的生命次数 |
7 |
%deathban_max_lives% |
该玩家组别的最大生命次数 |
10 |
%deathban_deaths% |
上次封禁以来的死亡次数 |
3 |
%deathban_bans% |
该玩家被封禁的总次数 |
2 |
在任何兼容 PAPI 的插件中使用这些占位符——计分板、标签页列表、聊天、全息图等。
⚙️ 配置
时间格式
控制向玩家显示封禁持续时间的格式。提供多种样式:
# 相对倒计时(默认)—— "10 hours", "45 minutes"
time-format: 'in 1 hours minutes? seconds?'
# 绝对日期 — “2026年3月10日 17:45:00”
time-format: 'date-format long long'
# 简洁格式 — “3小时45分”
time-format: 'in 3 hours minutes? seconds?'
# 自定义模式
time-format: 'custom-date-format dd-MM-yyyy HH:mm:ss'
生命值与禁赛时长
default:
lives: 10 # 触发禁赛前的死亡次数
time: 10h # 禁赛时长(支持 s, m, h, d, w)
# time: permanent # 永久禁赛
递增式禁赛 — 每个条目对应第 n 次违规,当列表用尽后,后续所有违规均为永久禁赛:
default:
lives: 10
time:
- 10m # 第一次禁赛:10分钟
- 1h # 第二次禁赛:1小时
- 12h # 第三次禁赛:12小时
- permanent # 第四次及以后:永久禁赛
权限组
为不同等级赋予独立的生存次数和禁赛时长。优先级最高的匹配组生效:
groups:
vip:
permission: deathban.group.vip
lives: 15
time: 2h
priority: 1
staff:
permission: deathban.group.staff
lives: 20
time: 30m
priority: 2
消息提示
每条消息均支持 & 颜色代码以及以下占位符:
| 占位符 |
描述 |
%player% |
玩家名称 |
%time% |
禁赛时长(由 time-format 格式化) |
%lives% |
剩余生命值 |
%maxlives% |
最大生命值 |
%deaths% |
当前死亡次数 |
%bans% |
总禁赛次数 |
messages:
# 当玩家在禁赛期间尝试重新连接时显示在登录界面
ban: |-
你因死亡被禁赛。
你将在 %time% 后被解禁。
ban-permanent: |-
你因死亡被永久禁赛。
# 应用禁赛时的即时踢出提示
kick: |-
你已死亡并被禁赛。
你将在 %time% 后被解禁。
kick-permanent: |-
你已死亡并被永久禁赛。
# 可选的全服广播(需设置 announce-ban: true)
announce: '%player% 已被禁赛 %time%'
announce-permanent: '%player% 已被永久禁赛'
禁赛广播
默认关闭。可随时启用并自定义——只需设置 announce-ban: true 并编辑消息即可:
announce-ban: false # 改为 true 以启用
messages:
announce: '%player% 已被禁赛 %time%'
announce-permanent: '%player% 已被永久禁赛'
复活系统
玩家可以使用 /revive <player> 牺牲自己的一个生命值来解除另一名玩家的禁赛。确认提示可防止意外自禁:
revive-confirm: 10 # 若复活操作会导致发送者被禁赛,则等待确认的秒数(0 = 无需确认)
revive-lives: all # 被复活玩家恢复的生命值数量(all / positive / negative)
revive-lives 示例:
all — 完全恢复生命值
3 — 固定恢复 3 点生命值
-2 — 最大生命值减去 2
原版禁赛列表集成
use-vanilla-bans: false
当设置为 true 时,DeathBan 会将所有禁赛同步至服务器内置的 /banlist。即使移除 DeathBan,被禁赛的玩家仍会在服务器层面被阻止加入。重置或复活操作会自动解除这些禁赛。
禁赛时执行的命令
当玩家被禁赛时自动运行自定义命令——可与任何外部插件集成:
default:
lives: 10
time: 10h
commands:
- 'broadcast %player% has been death banned!'
- 'lp user %player% parent set banned'
? 热重载
所有消息、分组、禁赛时长和设置均可通过一条命令即时重载——无需重启服务器:
/deathban reload
每次重载时,任何缺失的配置键都会自动从默认值中恢复。
? 致谢
最初由 Okx 创建。此分支通过增加 Folia 支持、永久禁赛、全服广播、原版禁赛列表集成以及对 1.13 至 1.21.x 所有服务器平台的全面兼容性,对该插件进行了现代化改造。
加入社区:discord.gg/qdmSv7usbJ
? bStats
☠️ 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:

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:

# 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 <player> |
Check another player's lives |
deathban.command.lives |
/revive <player> |
Transfer one of your lives to a banned player |
deathban.command.revive |
/deathban reset <player> |
Remove a ban and restore full lives |
deathban.command.admin |
/deathban set <player> <lives> |
Set a player's exact life count |
deathban.command.admin |
/deathban add <player> <lives> |
Add lives to a player |
deathban.command.admin |
/deathban ban <player> <time> |
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 |
deathban.command.admin |
op |
All admin sub-commands |
deathban.notify |
op |
Receive update notifications on join |
? PlaceholderAPI
Requires PlaceholderAPI to be installed.
| Placeholder |
Description |
Example Output |
%deathban_lives% |
Lives remaining before next ban |
7 |
%deathban_max_lives% |
Maximum lives for this player's group |
10 |
%deathban_deaths% |
Deaths since last ban |
3 |
%deathban_bans% |
Total number of times this player has been banned |
2 |
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:
| Placeholder |
Description |
%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
评论 0
登录后参与评分
还没有评论,来抢沙发吧