Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

PunishmentsSystem

github.com

  • Free plan
  • Self-hosted
6.7 Club score Visit github.com

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.