# BanSystem **A simple light-weight ban plugin for Paper 1.21x** ![Paper](https://img.shields.io/badge/Paper-1.21x-f87171?style=square) ![Java](https://img.shields.io/badge/Java-21-f97316?style=flat-square) --- *Running a server means dealing with people who break the rules at some point.* *BanSystem gives you the tools to handle that. In a way fast way and without installing a heavy multi-purpose plugin just for one thing.*

--- ## Why BanSystem? Most ban plugins are either too complicated or too simple. BanSystem is right in the middle. No database setup. No ten config files. No extra features taking up your server resources. Just put 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. Standard reasons and durations mean everyone on your team bans the way. No more `hacker` vs `hacking` vs `cheating` scattered in your history. --- ## Features ### bans that end by themselves Set a time like `7d` `12h` or `1mo` and forget about it. The moment the time ends the player is automatically unbanned. No need for cron jobs no work. ### Permanent bans for the ones who deserve it One command. They are gone for good unless a staff member decides otherwise. ### Ban screens players will actually read 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 screen. ### Full history on every player `/check ` shows everything. Every ban, every unban, who did it when and why. Useful when a player says they were never warned before or when you are deciding whether to give someone another chance. ### Staff broadcasts without the noise When a ban or unban happens only staff with the permission see the broadcast. Regular players are never bothered with 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. ### Standard reasons and durations Define your servers 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 team. ### Protect important players from being banned Give someone the `permission and no one can ban them through the plugin. Useful, for server owners or senior staff. ### Everything stored in one file No database. No extra plugins needed. All ban data lives in your `config.yml`. To read, edit and back 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 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`. Nbsp; `6h` `3d` `2w` `1mo` `1y` `1d12h` --- ## Compatibility | | | |---|---| | **Platform** Paper | | **Version** | 1.21x | *Java** |. | | **Dependencies** | None | ---

No dependencies. No setup. Just works.

JR_DEV