# \ud83d\udc80 Unstable Ban \u2014 Minecraft Plugin<\/p>\n
**Unstable Ban** brings **true hardcore vibes** to your Minecraft server by turning **player deaths into bans**.
\nEvery life counts \u2014 **one mistake and you’re out**.<\/p>\n
It functions just like the **banning system on Unstable SMP**, with a **few additional features**, but it’s **fully configurable** to behave *exactly* like **Unstable SMP** if desired.<\/p>\n
—<\/p>\n
## \u26a1 Core Idea<\/p>\n
Death is no longer just a setback.<\/p>\n
* You don’t respawn
\n* You don’t keep playing
\n* You get **banned**<\/p>\n
Whether temporary or permanent \u2014 **death finally means something**.<\/p>\n
—<\/p>\n
## \ud83d\udcac What Happens When a Player Dies<\/p>\n
* The plugin **detects the death instantly**
\n* A **ban command is sent to LibertyBans**
\n* The player is **automatically banned**
\n* A **Wither spawn sound** plays
\n* Nearby players **see the death message and hear the sound** (configurable radius)
\n* The player sees a **custom ban reason** (killer or natural cause)<\/p>\n
“`yaml
\n# The radius in which the death message\/sound will be seen\/heard when someone dies. 1 = 1 Block
\ndeath-radius: 1000<\/p>\n
# Should the plugin send a death message in the chat and\/or play a sound when someone dies ONLY IN THE ASSIGNED RADIUS?
\ndeath-message: true
\ndeath-sound: true<\/p>\n
# Only use sounds that are listed in https:\/\/hub.spigotmc.org\/javadocs\/spigot\/org\/bukkit\/Sound.html
\ndeath-sound-type: ENTITY_WITHER_SPAWN<\/p>\n
# The reason the player should see if he dies
\n# %player% = the name of the player who died
\n# %killer% = the name of the player who killed the player (if there is one)
\n# %banCount% = the amount of bans the player has after being killed
\nban-reason: “You were killed by %killer%!”<\/p>\n
# when there is no killer, the player should see this message
\nban-reason-natural-causes: “You died!”
\n“`<\/p>\n
No delays. No loopholes.
\nJust **pure consequences**.<\/p>\n
—<\/p>\n
## \u23f3 Ban Progression System<\/p>\n
Unstable Ban supports **escalating ban durations**, just like on **Unstable SMP**.<\/p>\n
“`yaml
\n# m = minutes, h = hours, d = days, mo = months
\n# for permanent bans, delete all durations except the first one and set it to “perm”
\nban-durations:
\n – “10m”
\n – “1h”
\n – “6h”
\n – “24h”
\n – “7d”<\/p>\n
# Should a players bans be reset after the last\/longest ban time
\nban-durations-last-reset: true
\n“`<\/p>\n
Each death increases the punishment.
\nAfter reaching the longest duration, bans can automatically reset (optional).<\/p>\n
Survive longer \u2014 or **pay the price**.<\/p>\n
—<\/p>\n
## \ud83d\udd04 Earn Your Way Back In<\/p>\n
If you’re using **temporary bans**, players can **reduce their ban counter** in two ways.<\/p>\n
### \u23f1\ufe0f By Spending Time on the Server<\/p>\n
“`yaml
\n# Should someone lose one ban after a certain time period?
\nlose-ban-after-time: true<\/p>\n
# s = seconds, m = minutes, h = hours, d = days
\nlose-ban-after-duration: “2h”<\/p>\n
# use -1 to remove all bans after the time period
\nlose-ban-amount: 1
\n“`<\/p>\n
If a player is on ban level 2 and the time passes,
\nthey’ll drop back to ban level 1 \u2014 meaning **shorter bans next time**.<\/p>\n
When they join while this system is active, a **boss bar countdown** shows the remaining time.<\/p>\n
“`yaml
\n# the color of the countdown boss bar
\ncountdown-bossbar-color: “RED”<\/p>\n
# The title on top of the boss bar
\n# Use %time% to show the remaining time until the next ban is removed
\ncountdown-bossbar-title: “\u00a7cYou will lose one ban in %time%”
\n“`<\/p>\n
—<\/p>\n
### \u2694\ufe0f By Killing Other Players<\/p>\n
High risk. High reward.<\/p>\n
“`yaml
\n# Should someone lose ban(s) after getting a kill?
\nlose-ban-after-kill: true<\/p>\n
# use -1 to remove all bans after the time period
\nlose-ban-amount-on-kill: -1
\n“`<\/p>\n
One kill can **wipe all previous bans** \u2014 if you’re brave enough.<\/p>\n
—<\/p>\n
## \ud83e\udde0 Why Unstable Ban Is Different<\/p>\n
* **Death = Consequence**
\n* **Escalating punishments**
\n* **Redemption through skill or patience**
\n* **Public deaths with sound & messages**
\n* **Full logging & moderation transparency**
\n* **Fully configurable hardcore experience**<\/p>\n
It’s not just a plugin \u2014 it’s **a ruleset for tension**.<\/p>\n
—<\/p>\n
### \ud83d\udce2 Join & Leave Radius Control<\/p>\n
Join and leave messages can also be limited to a specific radius.<\/p>\n
“`yaml
\n# Should leave messages only be sent to players in a certain radius around the player who left?
\nleave-msg-radius-enabled: true
\nleave-msg-radius: 1000<\/p>\n
# Should join messages only be sent to players in a certain radius around the player who joined?
\njoin-msg-radius-enabled: true
\njoin-msg-radius: 1000
\n“`<\/p>\n
—<\/p>\n
## \ud83c\udfae Perfect For<\/p>\n
* Hardcore SMPs
\n* Competitive survival servers
\n* Events & challenges
\n* Content creators
\n* Servers that want **real stakes**<\/p>\n
Every fight matters.
\nEvery heart matters.
\nEvery decision matters.<\/p>\n
—<\/p>\n
## \ud83d\udccb Commands \u2014 Unstable Ban<\/p>\n
| Command | Function | Permission | —<\/p>\n ## \ud83d\udce6 Installation<\/p>\n 1. Place `unstable-ban` in your `plugins\/` folder —<\/p>\n ## \ud83d\udd17 Dependencies<\/p>\n * LibertyBans<\/p>\n —<\/p>\n **Death finally means something.** Unstable Ban turns your server into a **true hardcore adventure** \ud83d\udc80\ud83d\udd25<\/p>\n","protected":false},"excerpt":{"rendered":" A remake of the banning system on Unstable with optional timed bans – easy configuration<\/p>\n","protected":false},"featured_media":162887,"template":"","meta":{"_minecraft_slug":"unstable-ban","_minecraft_project_id":"yK5HP519","_minecraft_author":"Blaulix","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":503,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"unstable-ban.zip","_minecraft_size_bytes":53348,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T10:32:41.178488Z","_minecraft_date_created":"2026-02-10T00:50:00.270344Z","_minecraft_date_modified":"2026-03-24T11:26:19.806758Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/unstable-ban","_minecraft_icon_attachment_id":162887,"_minecraft_imported_at":"2026-06-09T16:21:28+00:00","_minecraft_import_hash":"cc0188dab9f35f99a4524f6b925e5017","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,89,126,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-162886","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| ————————————— | ——————————— | ——————— |
\n| `\/unstableban bans` | Check your current ban count | Player |
\n| `\/ub bans` | Alias for `\/unstableban bans` | Player |
\n| `\/unstableban togglebossbar` | Toggle your ban countdown bossbar | Player |
\n| `\/ub togglebossbar` | Alias | Player |
\n| `\/unstableban help` | Show help message | `unstableban.help` |
\n| `\/ub help` | Alias | `unstableban.help` |
\n| `\/unstableban reload` | Reload configuration | `unstableban.reload` |
\n| `\/ub reload` | Alias | `unstableban.reload` |
\n| `\/unstableban getbans
\n| `\/unstableban setbans
\n2. Make sure **LibertyBans** is installed
\n3. Restart your server
\n4. Deaths now trigger bans automatically<\/p>\n
\n**Every life is precious. Every fight counts.**<\/p>\n