PunishBAN
github.com
- Free plan
- Self-hosted
What PunishBAN is
PunishBAN is a free, self-hosted punishment plugin for Paper Minecraft servers. It manages bans and mutes for online and offline players, using preset or custom durations and reasons. Its chat filter checks configured words without regard to capitalization and normalizes leetspeak. Staff receive clickable ban and mute alerts, with a cooldown to limit repeated notifications. Three filter violations within 24 hours trigger an automatic 24-hour ban; a racism-category violation results in a permanent ban on the first offense.
Staff can use `/playerinfo` to see a player's UUID, first and last login, punishment status, and alternate accounts sharing an IP. `/banlogs` lists ban and mute history, limited to the last 10 entries. Presets, filter words, and durations can be changed in `config.yml`. Data is kept in YAML files, so the plugin does not need a database. English and German are supported, with language changes available through commands without restarting. PunishBAN requires Paper 1.21.1+ and Java 21+. LuckPerms is recommended for permission management.
Who it suits
PunishBAN suits administrators of self-hosted Paper Minecraft servers who need configurable punishments, chat filtering, and staff-facing player history tools.
Good to know, and what to watch
- Handles bans and mutes for online and offline players.
- Filter alerts include clickable ban and mute controls.
- Language can switch between English and German without restarting.
- Player lookup includes alternate accounts sharing an IP.
- Requires Paper 1.21.1+ and Java 21+.
- Ban logs list only the last 10 entries.
The verdict
PunishBAN covers common ban, mute, filtering, and player lookup tasks without requiring a database. Check the server's Paper and Java versions first, and note that its ban-log view is limited to 10 entries.
What the maker publishes
- Automatic bans
- Three filter violations within 24 hours trigger an automatic 24-hour ban; a racism-category violation triggers a permanent ban on the first offense. source
- Automatic bans
- Three filter violations within 24 hours trigger an automatic 24-hour ban; the racism category triggers a permanent ban on the first offense. source
- Ban commands
- Ban commands work for online and offline players and accept presets, custom durations, and reasons. source
- Chat filter
- Its chat filter detects configured words with case-insensitive matching and leetspeak normalization, and sends staff clickable ban and mute notifications. source
- Chat filter
- The chat filter detects case-insensitive words and normalizes leetspeak. source
- Compatibility
- Modrinth lists Minecraft Java Edition 1.21.x and Paper as its compatibility and platform. source
- Configuration
- Presets, filter words, and durations are configurable in `config.yml`. source
- Configuration
- Presets, filter words, and durations are configurable in config.yml. source
- History limit
- The ban logs command shows ban and mute history for the last 10 entries. source
- Integration
- LuckPerms is recommended for permission management. source
- Languages
- It supports English and German, switchable with `/punish lang en` or `/punish lang de` without restarting. source
- Languages
- The plugin supports English and German, switchable without restarting the server. source
- License
- Modrinth lists the plugin as MIT licensed. source
- License
- The project is licensed under MIT. source
- Logs
- The `/banlogs` command displays ban and mute history, with the last 10 entries listed. source
- Mute commands
- The plugin provides mute and unmute commands using the ban preset system. source
- Player information
- The `/playerinfo` command shows UUID, first and last login, ban and mute status, and alt accounts sharing the same IP. source
- Player lookup
- The player info command shows UUID, login dates, punishment status, and alternate accounts sharing an IP. source
- Punishments
- It supports bans and mutes for online and offline players, with presets and custom durations. source
- Purpose
- PunishBAN is a lightweight punishment plugin for Paper Minecraft servers. source
- Purpose
- PunishBAN is a lightweight punishment plugin for Paper servers. source
- Requirements
- The stated requirements are Paper 1.21.1+ and Java 21+; LuckPerms is recommended for permission management. source
- Requirements
- It requires Paper 1.21.1 or newer and Java 21 or newer. source
- Staff alerts
- Staff receive clickable filter alerts with ban and mute buttons, and a cooldown limits notification flooding. source
Checked against the maker's pages on 4 Oct 2026.