Freedom251 › Minecraft Moderation Plugins
PunishmentsSystem
What PunishmentsSystem is
PunishmentsSystem is a self-hosted punishment system for moderators. Operators can configure reasons, punishment types, and durations for each offense step in the default `config.json` file. The `/punish` command applies a configured reason and duration, while `/manualpunish` lets moderators issue a punishment without using those presets. The documented punishment types are mute, ban, and kick.
Moderators can review a player's punishment history with `/check`, or use that command to look up a punishment by ID. They can also forgive a charge there; `/unban` serves as an alias for forgiving bans. Punishments apply across IP addresses, and `/checkip` can find accounts associated with an IP or player. The maker describes the system as easy to use. It is free and self-hosted, and the repository identifies its license as GPL-3.0. The maker says Paper code is available in the `paper` branch.
Who it suits
PunishmentsSystem suits server operators who want configured reasons and durations for moderator-issued mutes, bans, and kicks. It also fits teams that need commands for reviewing punishment records, finding related accounts, or forgiving charges.
What it does well
- Preset reasons and durations support consistent punishments.
- `/check` shows player history and accepts punishment IDs.
- Moderators can forgive charges through `/check`.
- `/checkip` finds accounts associated with an IP or player.
- Operators configure rules by offense step in `config.json`.
- The repository identifies the license as GPL-3.0.
What to know first
- It is self-hosted.
- Documented punishment types are limited to mute, ban, and kick.
Getting started
- Open the project's GitHub repository.
- Use the code in the `paper` branch if you need the Paper version.
- Configure reasons, punishment types, and durations by offense step in `config.json`.
- Use `/punish` for configured cases or `/manualpunish` to bypass presets.
Verdict
Choose PunishmentsSystem if you need a self-hosted moderator tool with configurable punishment rules and history lookup. Look elsewhere if your requirements call for punishment types beyond mute, ban, and kick.
Questions
How much does PunishmentsSystem cost?
It is free, and the facts list a Free plan.
Where can I use it?
It is self-hosted. The maker says Paper code is available in the `paper` branch.
What punishment types are documented?
Mute, ban, and kick.
What license does the repository use?
The repository identifies its license as GPL-3.0.
Can moderators review and reverse punishments?
Yes. `/check` shows a player's history and can look up a punishment by ID. Moderators can forgive a charge through `/check`, and `/unban` is an alias for forgiving bans.
Facts from PunishmentsSystem's own pages
- Configurable rules
- The configuration lets administrators set reasons and what action to take after specified durations. · github.com, 5 Oct 2026
- Configuration file
- The README identifies `config.json` as the default configuration file. · github.com, 5 Oct 2026
- Forgiveness
- Moderators can forgive a charge through `/check`, including unbanning or unmuting a player. · github.com, 5 Oct 2026
- IP-wide punishments
- Punishments apply IP-wide, and `/checkip <ip|player>` checks all accounts associated with one IP. · github.com, 5 Oct 2026
- License
- The repository displays a GPL-3.0 license. · github.com, 5 Oct 2026
- Manual punishment
- The /manualpunish command lets moderators issue punishments while ignoring presets. · github.com, 4 Oct 2026
- Manual punishments
- The `/manualpunish` command allows manual punishments while ignoring presets. · github.com, 5 Oct 2026
- Paper branch
- The README says the Paper code can be viewed in the `paper` branch. · github.com, 5 Oct 2026
- Preset punishments
- The `/punish` command uses preset reasons so moderators do not get confused about times. · github.com, 5 Oct 2026
- Pricing and trial
- The repository page does not state a price or trial offer. · github.com, 4 Oct 2026
- Punishment history
- The `/check` command displays a player's punishment history and lets moderators look up a punishment by ID. · github.com, 5 Oct 2026
- Punishment types
- The listed punishment types are MUTE, BAN, and KICK. · github.com, 5 Oct 2026
- Purpose
- Punishment System is described as an easy-to-use punishment system. · github.com, 5 Oct 2026
- Support and security
- The repository page provides no product support, security, or compliance details. · github.com, 4 Oct 2026
Where PunishmentsSystem stands on Freedom251
- Minecraft Moderation Plugins#9 of 19