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

🛡️ 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