PunisherX

[](https://github.com/SyntaxDevTeam/PunisherX/actions/workflows/gradle.yml)      # 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 * [x] Built for Paper 1.20.6, 1.21 - 1.21.11, 26.1-26.1.2 and compatible forks, including improved Folia support. * [x] Actively maintained with up-to-date APIs and full backward compatibility. * [x] Language file with full **MiniMessage** and Legacy formatting support. * [x] Support for Discord webhook integration. * [x] PlaceholderAPI support for dynamic placeholders. * [x] Easy database export/import via simple commands. * [x] Extensive configuration file for flexible customization. → Check the default settings [here](https://github.com/SyntaxDevTeam/PunisherX/blob/main/src/main/resources/config.yml) * [x] Update notification system with optional auto-update support. * [x] IP geolocation lookup support with a free MaxMind license key. * [x] Fallback ban system in case of database access issues. * [x] One-command full punishment clearance for any player. * [x] Full JAIL support via command or configuration. * [x] Requires Java 21 or higher. If you have questions or need help, feel free to join our [Discord](https://discord.gg/Zk6mxv7eMh) --- ## 📦 Download * Always up-to-date stable version available for download on: * Modrinth [](https://modrinth.com/plugin/punisherx) * Hangar [](https://hangar.papermc.io/SyntaxDevTeam/PunisherX) * SNAPSHOT and DEV versions available immediately on Github [](https://github.com/SyntaxDevTeam/PunisherX/releases) * You can also build the development version yourself [](https://github.com/SyntaxDevTeam/PunisherX) or download the last valid build [](https://github.com/SyntaxDevTeam/PunisherX/actions/workflows/gradle.yml) --- ## ⚙️ 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](https://github.com/SyntaxDevTeam/PunisherX/wiki)**. --- ## 📞 Contact If you need support or have any questions, join our [Discord](https://discord.gg/Zk6mxv7eMh) 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](https://github.com/SyntaxDevTeam/PunisherX/blob/main/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](mailto:[email protected]) or on our [Discord](https://discord.gg/Q343kjA2YP). You can also buy us a coffee for our work on [buymeacoffee.com/syntaxdevteam](https://buymeacoffee.com/syntaxdevteam)