PunisherX is a comprehensive punishment system offering commands like kick, warn, mute, jail, ban, and ban-ip — with both temporary and permanent options.
With support commands like /check, /history, and /banlist, administrators can quickly review a player's current punishment status or browse a full list of banned users.
Designed for speed and convenience, PunisherX includes customizable templates for punishment reasons, allowing quick and consistent enforcement. It also offers a complete message file for full translation and customization, supporting MiniMessage, Legacy, and plain Minecraft formatting. A detailed configuration file, an automatic migration system that preserves custom settings, and support for various database types (MySQL/MariaDB, PostgreSQL for multi-server sync, and SQLite/H2 for high-performance standalone use) make it flexible and production-ready.
- Built for Paper 1.20.6–1.21.11 and compatible forks, including improved Folia support.
- Actively maintained with up-to-date APIs and backward compatibility.
- Language files with full MiniMessage and Legacy formatting support, plus new translations.
- Support for Discord webhook integration.
- PlaceholderAPI support for dynamic placeholders.
- Easy database export/import/migrate via simple commands.
- Extensive configuration with automatic versioned migration that preserves admin changes.
- Flexible unjail behavior with five spawn modes and a dedicated
/setunjailcommand to avoid conflicts. - Action-bar countdowns for active punishments and configurable post-punishment actions, including warning escalation.
- Update notification system with optional auto-update support.
- IP geolocation lookup support with async processing and a free MaxMind license key.
- Fallback ban system in case of database access issues.
- One-command full punishment clearance for any player.
- Full jail support via command or configuration.
- Sync-Bridge modules for BungeeCord and Velocity.
- Requires Java 21 or higher.
If you have questions or need help, feel free to join our Discord
- Always up-to-date stable version available for download on:
- Modrinth
- Hangar
- Modrinth
- SNAPSHOT and DEV versions available immediately on Github
- You can also build the development version yourself
or download the last valid build
- Download the latest PunisherX release.
- Place the JAR file in your server's
pluginsfolder. - Start your Minecraft server.
- Configure: The
config.ymlfile contains a wide range of customization options.
PunisherX groups permissions by their purpose:
punisherx.cmd.*– access to commandspunisherx.manage.*– administrative configuration taskspunisherx.see.*– visibility of broadcasted punishments or updatespunisherx.bypass.*– ability to ignore specific punishments
A full list of commands and permissions is available in the Wiki.
If you need support or have any questions, join our Discord
or message us directly via DM.
This plugin is licensed under the MIT License.
You can find the full license text in the LICENSE file.
Thank you for using PunisherX! We hope it meets your expectations. 😊
