Freedom251 › Minecraft Moderation Plugins
PunishBAN
What PunishBAN is
PunishBAN is a free punishment plugin for self-hosted Paper Minecraft servers. It lets staff ban or mute online and offline players with presets, custom durations, and reasons. Its chat filter checks configured words without regard to capitalization and normalizes leetspeak. When a match occurs, staff can receive an alert with clickable ban and mute controls; a cooldown helps limit repeated notifications. Three filter violations in 24 hours trigger a 24-hour ban, while a violation in the racism category triggers a permanent ban on the first offense.
Staff can use `/playerinfo` to see a player's UUID, first and last login, ban and mute status, and alternate accounts sharing the same IP. `/banlogs` displays ban and mute history, with the last 10 entries shown. Presets, filter words, and durations can be changed in `config.yml`. PunishBAN stores its data in YAML files and does not require a database. English and German are available, with language changes made through `/punish lang en` or `/punish lang de` without restarting. It requires Paper 1.21.1+ and Java 21+; LuckPerms is recommended for permission management. Modrinth lists it under the MIT license.
Who it suits
PunishBAN suits administrators of self-hosted Paper Minecraft servers who need player punishments, chat filtering, and staff alerts. It is intended for servers running Paper 1.21.1+ with Java 21+ and staff who can configure the plugin through `config.yml`.
What it does well
- Punishes online and offline players with bans and mutes.
- Chat filter normalizes leetspeak and ignores capitalization.
- Staff alerts include clickable ban and mute controls.
- Player lookup includes IP-sharing alternate accounts.
- Stores data in YAML without a database.
- Supports English and German without restarting.
What to know first
- Requires Paper 1.21.1+ and Java 21+.
- Ban logs show only the last 10 entries.
- LuckPerms is recommended for permission management.
Limits
The `/banlogs` command displays the last 10 ban and mute history entries. The plugin requires Paper 1.21.1+ and Java 21+.
Getting started
- Open the PunishBAN source repository.
- Use a self-hosted server running Paper 1.21.1+ and Java 21+.
- Configure presets, filter words, and durations in `config.yml`.
- Set the plugin language with `/punish lang en` or `/punish lang de`.
- Use LuckPerms for permission management if needed.
Verdict
Choose PunishBAN for a Paper server that needs configurable bans, mutes, chat filtering, and player lookup without a database. It fits servers meeting its Paper and Java requirements; administrators seeking proxy support should look elsewhere, as proxy support is not included.
Questions
Is PunishBAN free?
Yes. It is listed as free, with a free plan.
Which server platform and versions does it support?
It is for self-hosted Paper servers. The stated requirement is Paper 1.21.1+; Modrinth lists Minecraft Java Edition 1.21.x and Paper.
Does PunishBAN require a database?
No. It stores data in YAML files.
What languages does it support?
English and German. Staff can switch with `/punish lang en` or `/punish lang de` without restarting.
What license does it use?
Modrinth lists PunishBAN as MIT licensed.
Does it integrate with LuckPerms?
LuckPerms is recommended for permission management.
Facts from PunishBAN's own pages
- 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, 4 Oct 2026
- Ban commands
- Ban commands work for online and offline players and accept presets, custom durations, and reasons. · github.com, 3 Oct 2026
- Chat filter
- The chat filter detects case-insensitive words and normalizes leetspeak. · modrinth.com, 4 Oct 2026
- Compatibility
- Modrinth lists Minecraft Java Edition 1.21.x and Paper as its compatibility and platform. · modrinth.com, 3 Oct 2026
- Configuration
- Presets, filter words, and durations are configurable in config.yml. · modrinth.com, 4 Oct 2026
- History limit
- The ban logs command shows ban and mute history for the last 10 entries. · modrinth.com, 4 Oct 2026
- Integration
- LuckPerms is recommended for permission management. · modrinth.com, 4 Oct 2026
- Languages
- The plugin supports English and German, switchable without restarting the server. · modrinth.com, 4 Oct 2026
- License
- The project is licensed under MIT. · modrinth.com, 4 Oct 2026
- Logs
- The `/banlogs` command displays ban and mute history, with the last 10 entries listed. · github.com, 3 Oct 2026
- Mute commands
- The plugin provides mute and unmute commands using the ban preset system. · github.com, 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, 3 Oct 2026
- Player lookup
- The player info command shows UUID, login dates, punishment status, and alternate accounts sharing an IP. · modrinth.com, 4 Oct 2026
- Punishments
- It supports bans and mutes for online and offline players, with presets and custom durations. · modrinth.com, 4 Oct 2026
- Purpose
- PunishBAN is a lightweight punishment plugin for Paper servers. · modrinth.com, 4 Oct 2026
- Requirements
- It requires Paper 1.21.1 or newer and Java 21 or newer. · modrinth.com, 4 Oct 2026
- Staff alerts
- Staff receive clickable filter alerts with ban and mute buttons, and a cooldown limits notification flooding. · modrinth.com, 4 Oct 2026
- Storage
- It requires no database and stores data in YAML files. · modrinth.com, 4 Oct 2026
- Support
- The Modrinth listing links to a Discord server and the source repository. · modrinth.com, 3 Oct 2026
Where PunishBAN stands on Freedom251
- Minecraft Moderation Plugins#8 of 19