---

Why BanSystem?

Most ban plugins are either way too bloated or way too basic. BanSystem sits right in the middle.

No database setup. No ten config files. No unnecessary features eating your server resources. Just drop the jar in, start the server, and you are ready to go.

Staff can ban players in seconds with tab-complete guiding them through every argument. Preset reasons and durations mean everyone on your team bans consistently — no more hacker vs hacking vs cheating scattered across your history.

---

Features

Temporary bans that expire on their own

Set a duration like 7d, 12h, or 1mo and forget about it. The moment the time runs out, the player is automatically unbanned. No cron jobs, no manual work.

Permanent bans for the ones who deserve it

One command and they are gone for good unless a staff member decides otherwise.

Ban screens players will actually read

Instead of a generic kick message, players see exactly who banned them, why, how long they have left, and when they can come back. Temporary and permanent bans each have their own screen.

Full history on every player

/check <player> shows everything — every ban, every unban, who did it, when, and why. Useful when a player claims they were never warned before, or when you are deciding whether to give someone another chance.

Staff broadcasts without the spam

When a ban or unban happens, only staff with the right permission see the broadcast. Regular players are never spammed with moderation messages they do not need to see.

Tab-complete on everything

Player names, temp or perm, durations, reasons — all of it shows up in tab-complete automatically. Your staff barely has to type.

Preset reasons and durations

Define your server's standard ban reasons once in the config and they appear in tab-complete for every staff member. Keeps your ban history clean and consistent across the whole team.

Protect important players from being banned

Give someone the bansystem.exempt permission and no one can ban them through the plugin. Useful for server owners or senior staff.

Everything stored in one file

No external database. No extra plugins required. All ban data lives in your config.yml — readable, editable, and backed up with the rest of your server files.

---

Commands

Command	Description
/ban temp <player> <duration> <reason>	Temporarily ban a player
/ban perm <player> <reason>	Permanently ban a player
/unban <player>	Unban a player
/check <player>	View the complete ban history of a player

---

Permissions

Permission	Description	Default
bansystem.ban	Ban players	op
bansystem.unban	Unban players	op
bansystem.check	View ban history	op
bansystem.broadcast.see	See ban/unban broadcasts	op
bansystem.exempt	Cannot be banned	false

---

Duration Format

Supports any combination of the following units:

Unit	Meaning
s	Seconds
m	Minutes
h	Hours
d	Days
w	Weeks
mo	Months
y	Years

Examples: 30m   6h   3d   2w   1mo   1y   1d12h

---

Compatibility

Platform	Paper
Version	1.21x
Java	21+
Dependencies	None

---