PunishBAN
1.1.0Lightweight punishment plugin with ban, mute, chat filter, auto-ban, alt detection and clickable staff notifications
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 enor/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
Smart Chat Filter
- Detects filtered words with leetspeak normalization (e.g.
n1gg3r→ detected) - Case insensitive
- Sends clickable notifications to staff with
[BAN]and[MUTE]buttons - Spam protection: cooldown prevents notification flooding
Auto-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.
Requirements
- Paper 1.21.1+
- Java 21+
- LuckPerms recommended for permission management
Similar projects
Plugin →Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta
Simple Tpa
A simple tpa plugin which sends requests
5.4MSueta
Common Network
Forge and Fabric Unified Networking Solution
3.9MSueta