{"id":25463,"date":"2026-06-01T12:11:41","date_gmt":"2026-06-01T09:11:41","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/"},"modified":"2026-06-01T12:11:41","modified_gmt":"2026-06-01T09:11:41","slug":"bansys","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/","title":{"rendered":"BanSys"},"content":{"rendered":"
\n

# BanSystem<\/p>\n

**A clean, lightweight ban plugin for Paper 1.21x**<\/p>\n

![Paper](https:\/\/img.shields.io\/badge\/Paper-1.21x-f87171?style=flat-square)
\n![Java](https:\/\/img.shields.io\/badge\/Java-21-f97316?style=flat-square)<\/p>\n

—<\/p>\n

*Running a server means dealing with rule-breakers sooner or later.*
\n*BanSystem gives you the tools to handle that \u2014 cleanly, quickly, and without installing a bloated multi-purpose plugin just for one feature.*<\/p>\n<\/div>\n

—<\/p>\n

## Why BanSystem?<\/p>\n

Most ban plugins are either way too bloated or way too basic. BanSystem sits right in the middle.<\/p>\n

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.<\/p>\n

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 \u2014 no more `hacker` vs `hacking` vs `cheating` scattered across your history.<\/p>\n

—<\/p>\n

## Features<\/p>\n

### Temporary bans that expire on their own
\nSet 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.<\/p>\n

### Permanent bans for the ones who deserve it
\nOne command and they are gone for good unless a staff member decides otherwise.<\/p>\n

### Ban screens players will actually read
\nInstead 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.<\/p>\n

### Full history on every player
\n`\/check ` shows everything \u2014 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.<\/p>\n

### Staff broadcasts without the spam
\nWhen 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.<\/p>\n

### Tab-complete on everything
\nPlayer names, `temp` or `perm`, durations, reasons \u2014 all of it shows up in tab-complete automatically. Your staff barely has to type.<\/p>\n

### Preset reasons and durations
\nDefine 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.<\/p>\n

### Protect important players from being banned
\nGive someone the `bansystem.exempt` permission and no one can ban them through the plugin. Useful for server owners or senior staff.<\/p>\n

### Everything stored in one file
\nNo external database. No extra plugins required. All ban data lives in your `config.yml` \u2014 readable, editable, and backed up with the rest of your server files.<\/p>\n

—<\/p>\n

## Commands<\/p>\n

| Command | Description |
\n|—|—|
\n| `\/ban temp ` | Temporarily ban a player |
\n| `\/ban perm ` | Permanently ban a player |
\n| `\/unban ` | Unban a player |
\n| `\/check ` | View the complete ban history of a player |<\/p>\n

—<\/p>\n

## Permissions<\/p>\n

| Permission | Description | Default |
\n|—|—|—|
\n| `bansystem.ban` | Ban players | op |
\n| `bansystem.unban` | Unban players | op |
\n| `bansystem.check` | View ban history | op |
\n| `bansystem.broadcast.see` | See ban\/unban broadcasts | op |
\n| `bansystem.exempt` | Cannot be banned | false |<\/p>\n

—<\/p>\n

## Duration Format<\/p>\n

Supports any combination of the following units:<\/p>\n

| Unit | Meaning |
\n|—|—|
\n| `s` | Seconds |
\n| `m` | Minutes |
\n| `h` | Hours |
\n| `d` | Days |
\n| `w` | Weeks |
\n| `mo` | Months |
\n| `y` | Years |<\/p>\n

> **Examples:** `30m`   `6h`   `3d`   `2w`   `1mo`   `1y`   `1d12h`<\/p>\n

—<\/p>\n

## Compatibility<\/p>\n

| | |
\n|—|—|
\n| **Platform** | Paper |
\n| **Version** | 1.21x |
\n| **Java** | 21+ |
\n| **Dependencies** | None |<\/p>\n

—<\/p>\n

\n

No dependencies. No setup. Just works.<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

An easy-to-set-up and customizable plugin that has everything you need. No annoying branding.<\/p>\n","protected":false},"featured_media":25464,"template":"","meta":{"_minecraft_slug":"bansys","_minecraft_project_id":"7ZGW1ZDk","_minecraft_author":"JR_DEV","_minecraft_license":"Apache-2.0","_minecraft_downloads":6,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bansys.zip","_minecraft_size_bytes":13821,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:28:13.919704Z","_minecraft_date_created":"2026-04-12T00:30:59.854883Z","_minecraft_date_modified":"2026-04-08T17:34:33.139613Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bansys","_minecraft_icon_attachment_id":25464,"_minecraft_imported_at":"2026-06-01T09:11:41+00:00","_minecraft_import_hash":"279e1af4ea7057eb00f6874ce99aea28","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,867,123,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-25463","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","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":"\nBanSys - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"BanSys - Minecraft\" \/>\n<meta property=\"og:description\" content=\"An easy-to-set-up and customizable plugin that has everything you need. No annoying branding.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bansys\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bansys\\\/\",\"name\":\"BanSys - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bansys\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bansys\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/bansys-icon-a4add8d2f431df2dedf12d69a7ab39b6916331db_96.webp\",\"datePublished\":\"2026-06-01T09:11:41+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bansys\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bansys\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bansys\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/bansys-icon-a4add8d2f431df2dedf12d69a7ab39b6916331db_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/bansys-icon-a4add8d2f431df2dedf12d69a7ab39b6916331db_96.webp\",\"width\":96,\"height\":95},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bansys\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"BanSys\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"BanSys - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/","og_locale":"en_US","og_type":"article","og_title":"BanSys - Minecraft","og_description":"An easy-to-set-up and customizable plugin that has everything you need. No annoying branding.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/","name":"BanSys - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/bansys-icon-a4add8d2f431df2dedf12d69a7ab39b6916331db_96.webp","datePublished":"2026-06-01T09:11:41+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/bansys\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/bansys-icon-a4add8d2f431df2dedf12d69a7ab39b6916331db_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/bansys-icon-a4add8d2f431df2dedf12d69a7ab39b6916331db_96.webp","width":96,"height":95},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/bansys\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"BanSys"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/25463","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/25464"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=25463"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=25463"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=25463"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=25463"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}