# BanSystem **A clean, lightweight ban plugin for Paper 1.21x** ![Paper](https://img.shields.io/badge/Paper-1.21x-f87171?style=flat-square) ![Java](https://img.shields.io/badge/Java-21-f97316?style=flat-square) --- *Running a server means dealing with rule-breakers sooner or later.* *BanSystem gives you the tools to handle that — cleanly, quickly, and without installing a bloated multi-purpose plugin just for one feature.*

--- ## 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 ` 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 ` | Temporarily ban a player | | `/ban perm ` | Permanently ban a player | | `/unban ` | Unban a player | | `/check ` | 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 | ---

No dependencies. No setup. Just works.

JR_DEV