PunishBAN

Lightweight punishment plugin with ban, mute, chat filter, auto-ban, alt detection and clickable staff notifications

Quick challenge

How far can you run before the mobs catch you?

PunishBAN

Punish

A lightweight, all-in-one punishment plugin for Paper 1.21.1+ servers. No database required — everything is stored in simple YAML files.

> 🌍 Multi-language support built-in! Switch between English and German at any time with `/punish lang en` or `/punish lang de` — no restart required.

Features

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

🔇 Mute System - `/mute <player> <preset> [duration] [reason]` - Same preset system as bans

🛡️ clickable notifications - Detects filtered words with clickable notifications (e.g. `n1gg3r` → detected) - Case insensitive - Sends clickable notifications to staff with `[BAN]` and `[MUTE]` buttons - Spam protection: cooldown prevents notification flooding

⚡ instant permanent ban - 3 filter violations within 24 hours → automatic 24h ban - Racism (RA) category → instant permanent ban on first offense

🔍 Player Info & Logs - `/playerinfo <player>` — UUID, first/last login, ban/mute status, alt accounts (same IP) - `/banlogs <player>` — full ban & mute history (last 10 entries)

Commands

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

Permissions

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

Ban & Mute Presets

| Preset | Category | Default Duration | |--------|----------|-----------------| | RA | Racism | Permanent | | HR | Hate Speech | 4 days | | WR | Advertising | 1 day | | SP | Spam | 1 day | | TX | Toxic Behavior | 2 days |

All presets, filter words, and durations are fully configurable in `config.yml`.