PunisherX

Proudly Introducing PunisherX

PunisherX is an advanced moderation plugin for Paper/Folia servers focused on punishments, investigation tools, and admin workflow automation. It provides complete punishment coverage (/ban, /banip, /mute, /jail, /warn, /kick) with temporary/permanent durations, plus direct recovery commands (/unban, /unmute, /unjail, /unwarn, /clearall).

The plugin also includes operator tools such as /check, /history, /banlist, /change-reason, and /punish templates, as well as GUI panels for moderators and report handling. PunisherX supports message customization with MiniMessage/Legacy/plain formats, config auto-migration between versions, and multiple database backends (SQLite, H2, MySQL, MariaDB, PostgreSQL) for both standalone and network environments.

✅ Key Features

• Built for Paper 1.20.6, 1.21 - 1.21.11, 26.1-26.1.2 and compatible forks, including improved Folia support.
• Actively maintained with up-to-date APIs and full backward compatibility.
• Language file with full MiniMessage and Legacy formatting support.
• Support for Discord webhook integration.
• PlaceholderAPI support for dynamic placeholders.
• Easy database export/import via simple commands.
• Extensive configuration file for flexible customization.
  → Check the default settings here
• Update notification system with optional auto-update support.
• IP geolocation lookup support with 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.
• Requires Java 21 or higher.

If you have questions or need help, feel free to join our Discord

📦 Download

• Always up-to-date stable version available for download on:
  • Modrinth
  • Hangar
• SNAPSHOT and DEV versions available immediately on Github
• You can also build the development version yourself or download the last valid build

⚙️ Installation

1. Download the latest PunisherX release.
2. Place the JAR file in your server's plugins folder.
3. Start your Minecraft server.
4. Configure: The config.yml file contains a wide range of customization options.

💬 Commands & Permissions

A full list of commands and permissions is available in the Wiki.

📞 Contact

If you need support or have any questions, join our Discord
or message us directly via DM.

📄 License

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. 😊

We are raising funds for better test machines or VPS. Would you like to support us financially? Write to me at e-mail or on our Discord. You can also buy us a coffee for our work on buymeacoffee.com/syntaxdevteam