PunishBAN
PunishBAN is a free, self-hosted punishment plugin for Paper Minecraft servers.
What PunishBAN is
PunishBAN is a free, self-hosted punishment plugin for Paper Minecraft servers. It handles bans and mutes for online and offline players, with presets, custom durations, and reasons. Its chat filter checks configured words without regard to capitalization and normalizes leetspeak. Staff receive clickable alerts with ban and mute actions, and a cooldown limits notification flooding. Three filter violations within 24 hours lead to an automatic 24-hour ban; a violation in the racism category triggers a permanent ban on the first offense. The `/playerinfo` command shows a player's UUID, first and last login, ban and mute status, and alternate accounts sharing the same IP. `/banlogs` lists ban and mute history, with the last 10 entries shown. Presets, filter words, and durations can be configured in `config.yml`. The plugin stores data in YAML files and supports English and German, which staff can switch without restarting. It requires Paper 1.21.1+ and Java 21+; LuckPerms is recommended for permission management.
Good
- Handles bans and mutes for online and offline players
- Chat filter supports case-insensitive and leetspeak matching
- Player information includes alternate accounts sharing an IP
- English and German can be switched without restarting
Watch out
- Requires Paper 1.21.1+ and Java 21+
- Ban logs show only the last 10 entries
Who it suits
PunishBAN is for Paper server administrators who need configurable player punishments and chat filtering. It suits servers meeting its Paper 1.21.1+ and Java 21+ requirements.
Verdict
PunishBAN combines configurable punishments, automatic filter responses, player lookups, and short punishment logs. Server operators should check its platform requirements and automatic-ban rules before configuring it.
The facts
Each one read from PunishBAN's own pages, with the date it was checked.
What it does
- 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.checked 4 Oct 2026
- Ban commands
- Ban commands work for online and offline players and accept presets, custom durations, and reasons.checked 3 Oct 2026
- Chat filter
- The chat filter detects case-insensitive words and normalizes leetspeak.checked 4 Oct 2026
- Compatibility
- Modrinth lists Minecraft Java Edition 1.21.x and Paper as its compatibility and platform.checked 3 Oct 2026
- Configuration
- Presets, filter words, and durations are configurable in config.yml.checked 4 Oct 2026
- History limit
- The ban logs command shows ban and mute history for the last 10 entries.checked 4 Oct 2026
- Integration
- LuckPerms is recommended for permission management.checked 4 Oct 2026
- Languages
- The plugin supports English and German, switchable without restarting the server.checked 4 Oct 2026
- License
- The project is licensed under MIT.checked 4 Oct 2026
- Logs
- The `/banlogs` command displays ban and mute history, with the last 10 entries listed.checked 3 Oct 2026
- Mute commands
- The plugin provides mute and unmute commands using the ban preset system.checked 3 Oct 2026
- Player information
- The `/playerinfo` command shows UUID, first and last login, ban and mute status, and alt accounts sharing the same IP.checked 3 Oct 2026
- Player lookup
- The player info command shows UUID, login dates, punishment status, and alternate accounts sharing an IP.checked 4 Oct 2026
- Punishments
- It supports bans and mutes for online and offline players, with presets and custom durations.checked 4 Oct 2026
- Purpose
- PunishBAN is a lightweight punishment plugin for Paper servers.checked 4 Oct 2026
- Requirements
- It requires Paper 1.21.1 or newer and Java 21 or newer.checked 4 Oct 2026
- Staff alerts
- Staff receive clickable filter alerts with ban and mute buttons, and a cooldown limits notification flooding.checked 4 Oct 2026
- Storage
- It requires no database and stores data in YAML files.checked 4 Oct 2026
- Support
- The Modrinth listing links to a Discord server and the source repository.checked 3 Oct 2026
Alternatives to PunishBAN
- 1
LibertyBans
Free planAPISelf-hosted6.2Free plan - 2
ModGUI
Free planSelf-hosted6.2Free plan - 3
Staff+
Free planSelf-hosted6.2Free plan - 4
BanManager
WebAPILinuxSelf-hosted5.9 - 5
ExtraBan
Free planSelf-hosted5.6Free plan - 6
Player Report
Free planSelf-hosted5.6Free plan