- Home
- Minecraft Moderation Plugins
- PunishBAN
PunishBAN
What it is
PunishBAN is a free, self-hosted punishment plugin for Paper Minecraft servers. It manages bans and mutes for online or offline players, using 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 controls, while a cooldown limits notification flooding. Three filter violations within 24 hours cause an automatic 24-hour ban; a racism-category violation causes a permanent ban on the first offense. The `/playerinfo` command displays UUID, first and last login, punishment status, and alternate accounts sharing an IP. `/banlogs` shows ban and mute history, listing the last 10 entries. Presets, filter words, and durations are configured in `config.yml`. Data is stored in YAML files without a database. English and German can be switched without restarting. Requirements are Paper 1.21.1+ and Java 21+; LuckPerms is recommended.
For and against
For
- Handles online and offline player punishments
- Configurable chat filtering with leetspeak normalization
- Clickable staff ban and mute alerts
- YAML storage requires no database
- English and German language switching
Against
- Requires Paper 1.21.1+ and Java 21+
- Ban logs list only the last 10 entries
- No proxy support
The verdict
PunishBAN combines configurable bans, mutes, filtering, staff alerts, and player lookup in a self-hosted Paper plugin. Its stated platform requirements and limited ban-log history are important considerations.
Who it suits
It suits administrators of self-hosted Paper Minecraft servers needing configurable punishments and chat filtering. It is aimed at servers using Paper 1.21.1+ and Java 21+.
On the record
- 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.modrinth.com · read 4 Oct 2026
- Ban commands
- Ban commands work for online and offline players and accept presets, custom durations, and reasons.github.com · read 3 Oct 2026
- Chat filter
- The chat filter detects case-insensitive words and normalizes leetspeak.modrinth.com · read 4 Oct 2026
- Compatibility
- Modrinth lists Minecraft Java Edition 1.21.x and Paper as its compatibility and platform.modrinth.com · read 3 Oct 2026
- Configuration
- Presets, filter words, and durations are configurable in config.yml.modrinth.com · read 4 Oct 2026
- History limit
- The ban logs command shows ban and mute history for the last 10 entries.modrinth.com · read 4 Oct 2026
- Integration
- LuckPerms is recommended for permission management.modrinth.com · read 4 Oct 2026
- Languages
- The plugin supports English and German, switchable without restarting the server.modrinth.com · read 4 Oct 2026
- License
- The project is licensed under MIT.modrinth.com · read 4 Oct 2026
- Logs
- The `/banlogs` command displays ban and mute history, with the last 10 entries listed.github.com · read 3 Oct 2026
- Mute commands
- The plugin provides mute and unmute commands using the ban preset system.github.com · read 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.github.com · read 3 Oct 2026
- Player lookup
- The player info command shows UUID, login dates, punishment status, and alternate accounts sharing an IP.modrinth.com · read 4 Oct 2026
- Punishments
- It supports bans and mutes for online and offline players, with presets and custom durations.modrinth.com · read 4 Oct 2026
- Purpose
- PunishBAN is a lightweight punishment plugin for Paper servers.modrinth.com · read 4 Oct 2026
- Requirements
- It requires Paper 1.21.1 or newer and Java 21 or newer.modrinth.com · read 4 Oct 2026
- Staff alerts
- Staff receive clickable filter alerts with ban and mute buttons, and a cooldown limits notification flooding.modrinth.com · read 4 Oct 2026
- Storage
- It requires no database and stores data in YAML files.modrinth.com · read 4 Oct 2026
