PunishmentsSystem
github.com
- Free plan
- Self-hosted
What PunishmentsSystem is
PunishmentsSystem is a self-hosted tool for moderators managing player punishments. The /punish command applies preset reasons and durations, while operators define those rules in the default config.json file. The configuration can set reasons, punishment types, and durations for each offense step; documented types are mute, ban, and kick. Moderators can use /check to review a player's punishment history or search for a punishment by ID. The same command can forgive a charge, and /unban is an alias for forgiving bans. Punishments apply across IP addresses, and /checkip can find accounts associated with an IP or player. When presets do not fit a case, /manualpunish lets moderators issue a punishment without using them. The maker describes the system as easy to use. The README identifies a Paper branch containing Paper code, and the repository lists the GPL-3.0 license. It is free to use, but the repository page does not state a trial offer or provide product support, security, or compliance details.
Who it suits
It suits server operators who need configurable punishment rules and moderator commands for tracking, forgiving, or applying actions. Operators should be comfortable with a self-hosted project and its configuration file.
Good to know, and what to watch
- Preset reasons and durations support consistent moderation
- Punishment history can be checked by player or ID
- Supports mute, ban, and kick
- GPL-3.0 license
- Repository lists no product support details
- Repository lists no security or compliance details
- Repository page states no trial offer
The verdict
PunishmentsSystem brings configurable rules and several moderation actions into a self-hosted project. Review its available documentation and the absence of listed support and security details before adopting it.
What the maker publishes
- Configurable rules
- The configuration lets operators define reasons, punishment types, and durations by offense step. source
- Configurable rules
- The configuration lets administrators set reasons and what action to take after specified durations. source
- Configuration file
- The README identifies `config.json` as the default configuration file. source
- Forgiveness
- Moderators can forgive a charge through /check, and /unban is an alias for forgiving bans. source
- Forgiveness
- Moderators can forgive a charge through `/check`, including unbanning or unmuting a player. source
- IP-wide punishments
- Punishments apply across IP addresses, and /checkip can look up accounts associated with an IP or player. source
- IP-wide punishments
- Punishments apply IP-wide, and `/checkip <ip|player>` checks all accounts associated with one IP. source
- License
- The repository identifies its license as GPL-3.0. source
- License
- The repository displays a GPL-3.0 license. source
- Manual punishment
- The /manualpunish command lets moderators issue punishments while ignoring presets. source
- Manual punishments
- The `/manualpunish` command allows manual punishments while ignoring presets. source
- Paper branch
- The README says the Paper code is available in the paper branch. source
- Paper branch
- The README says the Paper code can be viewed in the `paper` branch. source
- Preset punishments
- The /punish command uses preset reasons and durations to help moderators apply punishments consistently. source
- Preset punishments
- The `/punish` command uses preset reasons so moderators do not get confused about times. source
- Pricing and trial
- The repository page does not state a price or trial offer. source
- Punishment history
- The /check command shows a player's punishment history and lets moderators look up a punishment by ID. source
- Punishment history
- The `/check` command displays a player's punishment history and lets moderators look up a punishment by ID. source
- Punishment types
- The documented punishment types are mute, ban, and kick. source
- Punishment types
- The listed punishment types are MUTE, BAN, and KICK. source
- Purpose
- The maker describes Punishments System as an easy-to-use punishment system. source
- Purpose
- Punishment System is described as an easy-to-use punishment system. source
- Support and security
- The repository page provides no product support, security, or compliance details. source
Checked against the maker's pages on 5 Oct 2026.