Skip to content
SPECIFICTION
Get listed

PunishBAN

github.com

Self-hosted
Visit github.com
Spec score 6.9 #10 of 19 in Minecraft Moderation Plugins

What it is

PunishBAN is a lightweight punishment plugin for self-hosted Paper Minecraft servers. It handles bans and mutes for players who are online or offline, using presets or custom durations and reasons. Its chat filter checks configured terms without regard to capitalization and normalizes leetspeak. Staff can 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 violation in the racism category results in a permanent ban on the first offense. The `/playerinfo` command shows a player's UUID, first and last login, punishment status and alternate accounts that share an IP. `/banlogs` displays ban and mute history, listing the last 10 entries. Presets, filter terms and durations can be configured in `config.yml`. The plugin stores data in YAML files and does not require a database. It supports English and German, which can be switched without restarting. Its requirements are Paper 1.21.1+ and Java 21+; LuckPerms is recommended for permission management.

Spec sheet

Purpose
PunishBAN is a lightweight punishment plugin for Paper servers.Read 4 Oct 2026 · modrinth.com
Support
The Modrinth listing links to a Discord server and the source repository.Read 3 Oct 2026 · modrinth.com
License
The project is licensed under MIT.Read 4 Oct 2026 · modrinth.com
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.Read 4 Oct 2026 · modrinth.com
Ban commands
Ban commands work for online and offline players and accept presets, custom durations, and reasons.Read 3 Oct 2026 · github.com
Chat filter
The chat filter detects case-insensitive words and normalizes leetspeak.Read 4 Oct 2026 · modrinth.com
Compatibility
Modrinth lists Minecraft Java Edition 1.21.x and Paper as its compatibility and platform.Read 3 Oct 2026 · modrinth.com
Configuration
Presets, filter words, and durations are configurable in config.yml.Read 4 Oct 2026 · modrinth.com
History limit
The ban logs command shows ban and mute history for the last 10 entries.Read 4 Oct 2026 · modrinth.com
Integration
LuckPerms is recommended for permission management.Read 4 Oct 2026 · modrinth.com
Languages
The plugin supports English and German, switchable without restarting the server.Read 4 Oct 2026 · modrinth.com
Logs
The `/banlogs` command displays ban and mute history, with the last 10 entries listed.Read 3 Oct 2026 · github.com
Mute commands
The plugin provides mute and unmute commands using the ban preset system.Read 3 Oct 2026 · github.com
Player information
The `/playerinfo` command shows UUID, first and last login, ban and mute status, and alt accounts sharing the same IP.Read 3 Oct 2026 · github.com
Player lookup
The player info command shows UUID, login dates, punishment status, and alternate accounts sharing an IP.Read 4 Oct 2026 · modrinth.com
Punishments
It supports bans and mutes for online and offline players, with presets and custom durations.Read 4 Oct 2026 · modrinth.com
Requirements
It requires Paper 1.21.1 or newer and Java 21 or newer.Read 4 Oct 2026 · modrinth.com
Staff alerts
Staff receive clickable filter alerts with ban and mute buttons, and a cooldown limits notification flooding.Read 4 Oct 2026 · modrinth.com
Storage
It requires no database and stores data in YAML files.Read 4 Oct 2026 · modrinth.com

Strong points and limits

Strong points

  • Handles bans and mutes for online and offline players.
  • Chat filter normalizes leetspeak and ignores capitalization.
  • Clickable staff alerts include ban and mute controls.
  • Stores data in YAML without requiring a database.
  • English and German can be switched without restarting.

Limits

  • Requires Paper 1.21.1+ and Java 21+.
  • Ban logs list only the last 10 entries.
  • LuckPerms is recommended for permission management.

Who it suits

PunishBAN suits administrators of self-hosted Paper Minecraft servers who need configurable bans, mutes and chat filtering. Its stated requirements are Paper 1.21.1+ and Java 21+.

Verdict

PunishBAN combines manual and automatic punishments with chat filtering and player lookup for Paper servers. Administrators should note its version requirements and the 10-entry history display limit.

Where Specifiction places it

Alternatives to PunishBANAll alternatives →