Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

PunishBAN

github.com

  • Free plan
  • Self-hosted
6.9 Club score Visit github.com

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.