{"id":126210,"date":"2026-06-07T13:03:03","date_gmt":"2026-06-07T10:03:03","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/"},"modified":"2026-06-07T13:03:03","modified_gmt":"2026-06-07T10:03:03","slug":"punishban","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/","title":{"rendered":"PunishBAN"},"content":{"rendered":"

# Punish<\/p>\n

A lightweight, all-in-one punishment plugin for Paper 1.21.1+ servers. No database required \u2014 everything is stored in simple YAML files.<\/p>\n

> \ud83c\udf0d **Multi-language support built-in!** Switch between English and German at any time with `\/punish lang en` or `\/punish lang de` \u2014 no restart required.<\/p>\n

## Features<\/p>\n

\ud83d\udd28 **Ban System**
\n– `\/ban [duration] [reason]` \u2014 works online & offline
\n– Built-in presets: RA, HR, WR, SP, TX, hacking, illegal mods
\n– Custom durations (`1d`, `12h`, `30m`) or use preset defaults
\n– Permanent keywords: certain words in the reason force a permanent ban<\/p>\n

\ud83d\udd07 **Mute System**
\n– `\/mute [duration] [reason]`
\n– Same preset system as bans<\/p>\n

\ud83d\udee1\ufe0f **Smart Chat Filter**
\n– Detects filtered words with **leetspeak normalization** (e.g. `n1gg3r` \u2192 detected)
\n– Case insensitive
\n– Sends **clickable notifications** to staff with `[BAN]` and `[MUTE]` buttons
\n– Spam protection: cooldown prevents notification flooding<\/p>\n

\u26a1 **Auto-Ban**
\n– 3 filter violations within 24 hours \u2192 automatic 24h ban
\n– Racism (RA) category \u2192 **instant permanent ban** on first offense<\/p>\n

\ud83d\udd0d **Player Info & Logs**
\n– `\/playerinfo ` \u2014 UUID, first\/last login, ban\/mute status, alt accounts (same IP)
\n– `\/banlogs ` \u2014 full ban & mute history (last 10 entries)<\/p>\n

## Commands<\/p>\n

| Command | Description | Permission |
\n|———|————-|————|
\n| `\/ban [duration] [reason]` | Ban a player | `punish.ban` |
\n| `\/unban ` | Unban a player | `punish.ban` |
\n| `\/mute [duration] [reason]` | Mute a player | `punish.mute` |
\n| `\/unmute ` | Unmute a player | `punish.mute` |
\n| `\/playerinfo ` | View player info | `punish.info` |
\n| `\/banlogs ` | View punishment history | `punish.logs` |
\n| `\/punish reload` | Reload config.yml | `punish.admin` |
\n| `\/punish lang ` | Switch plugin language | `punish.admin` |<\/p>\n

## Permissions<\/p>\n

| Permission | Description |
\n|———–|————-|
\n| `punish.ban` | Ban & unban players |
\n| `punish.mute` | Mute & unmute players |
\n| `punish.info` | View player info |
\n| `punish.logs` | View ban\/mute logs |
\n| `punish.notify` | Receive chat filter alerts |
\n| `punish.admin` | Use \/punish reload & \/punish lang |<\/p>\n

## Ban & Mute Presets<\/p>\n

| Preset | Category | Default Duration |
\n|——–|———-|—————–|
\n| RA | Racism | Permanent |
\n| HR | Hate Speech | 4 days |
\n| WR | Advertising | 1 day |
\n| SP | Spam | 1 day |
\n| TX | Toxic Behavior | 2 days |<\/p>\n

All presets, filter words, and durations are fully configurable in `config.yml`.<\/p>\n

## Requirements
\n– Paper 1.21.1+
\n– Java 21+
\n– LuckPerms recommended for permission management<\/p>\n","protected":false},"excerpt":{"rendered":"

Lightweight punishment plugin with ban, mute, chat filter, auto-ban, alt detection and clickable staff notifications<\/p>\n","protected":false},"featured_media":126211,"template":"","meta":{"_minecraft_slug":"punishban","_minecraft_project_id":"forgkSZN","_minecraft_author":"Jaromc_","_minecraft_license":"MIT","_minecraft_downloads":22,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"punishban.zip","_minecraft_size_bytes":70676,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:25:36.973039Z","_minecraft_date_created":"2026-03-19T21:01:47.788967Z","_minecraft_date_modified":"2026-03-15T16:44:45.635310Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/punishban","_minecraft_icon_attachment_id":126211,"_minecraft_imported_at":"2026-06-07T10:03:03+00:00","_minecraft_import_hash":"5d8fa3fc17eb35c9907d077d702f5a64","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-126210","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_loader-paper","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":"\nPunishBAN - 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\/punishban\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PunishBAN - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Lightweight punishment plugin with ban, mute, chat filter, auto-ban, alt detection and clickable staff notifications\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/\" \/>\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=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punishban\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punishban\\\/\",\"name\":\"PunishBAN - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punishban\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punishban\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/punishban-icon-1f4fb61777696b1bce7c89b7d3f3c2f66183e417_96.webp\",\"datePublished\":\"2026-06-07T10:03:03+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punishban\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punishban\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punishban\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/punishban-icon-1f4fb61777696b1bce7c89b7d3f3c2f66183e417_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/punishban-icon-1f4fb61777696b1bce7c89b7d3f3c2f66183e417_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punishban\\\/#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\":\"PunishBAN\"}]},{\"@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":"PunishBAN - 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\/punishban\/","og_locale":"en_US","og_type":"article","og_title":"PunishBAN - Minecraft","og_description":"Lightweight punishment plugin with ban, mute, chat filter, auto-ban, alt detection and clickable staff notifications","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/","name":"PunishBAN - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/punishban-icon-1f4fb61777696b1bce7c89b7d3f3c2f66183e417_96.webp","datePublished":"2026-06-07T10:03:03+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/punishban\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/punishban-icon-1f4fb61777696b1bce7c89b7d3f3c2f66183e417_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/punishban-icon-1f4fb61777696b1bce7c89b7d3f3c2f66183e417_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/punishban\/#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":"PunishBAN"}]},{"@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\/126210","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\/126211"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=126210"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=126210"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=126210"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=126210"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}