Skip to content
SPECIFICTION
Get listed

PunishmentsSystem

github.com

Self-hosted
Visit github.com
Spec score 6.5 #12 of 19 in Minecraft Moderation Plugins

What it is

PunishmentsSystem is a self-hosted system for moderators managing player punishments. The /punish command applies configured reasons and durations, helping operators use consistent presets. When a case falls outside those presets, /manualpunish issues a punishment while ignoring them. Operators define reasons, punishment types, and durations for each offense step in the default config.json file. The documented punishment types are mute, ban, and kick. Moderators can use /check to view a player’s punishment history or find a punishment by ID. That command also allows a charge to be forgiven, while /unban provides an alias for forgiving bans. Punishments apply across IP addresses, and /checkip can find accounts associated with an IP or player. The project’s README says its Paper code is in the paper branch. The GitHub repository identifies the license as GPL-3.0. The maker describes it as easy to use. It is free and self-hosted.

Spec sheet

Purpose
Punishment System is described as an easy-to-use punishment system.Read 5 Oct 2026 · github.com
License
The repository displays a GPL-3.0 license.Read 5 Oct 2026 · github.com
Configurable rules
The configuration lets administrators set reasons and what action to take after specified durations.Read 5 Oct 2026 · github.com
Configuration file
The README identifies `config.json` as the default configuration file.Read 5 Oct 2026 · github.com
Forgiveness
Moderators can forgive a charge through `/check`, including unbanning or unmuting a player.Read 5 Oct 2026 · github.com
IP-wide punishments
Punishments apply IP-wide, and `/checkip <ip|player>` checks all accounts associated with one IP.Read 5 Oct 2026 · github.com
Manual punishment
The /manualpunish command lets moderators issue punishments while ignoring presets.Read 4 Oct 2026 · github.com
Manual punishments
The `/manualpunish` command allows manual punishments while ignoring presets.Read 5 Oct 2026 · github.com
Paper branch
The README says the Paper code can be viewed in the `paper` branch.Read 5 Oct 2026 · github.com
Preset punishments
The `/punish` command uses preset reasons so moderators do not get confused about times.Read 5 Oct 2026 · github.com
Pricing and trial
The repository page does not state a price or trial offer.Read 4 Oct 2026 · github.com
Punishment history
The `/check` command displays a player's punishment history and lets moderators look up a punishment by ID.Read 5 Oct 2026 · github.com
Punishment types
The listed punishment types are MUTE, BAN, and KICK.Read 5 Oct 2026 · github.com
Support and security
The repository page provides no product support, security, or compliance details.Read 4 Oct 2026 · github.com

Strong points and limits

Strong points

  • Preset reasons and durations support consistency
  • Punishment history can be searched by ID
  • IP-wide punishment lookup is included
  • Manual punishments bypass configured presets
  • GPL-3.0 repository license

Limits

  • Self-hosted deployment is required
  • No product support details are provided
  • No security or compliance details are provided

Who it suits

PunishmentsSystem suits server operators and moderators who need configurable, command-based punishment handling. It is for teams prepared to host and configure the project themselves.

Verdict

PunishmentsSystem covers preset and manual punishments, history checks, forgiveness, and IP-based lookups. Its self-hosted, GPL-3.0 repository format leaves operators responsible for deployment and related support considerations.

Where Specifiction places it

Alternatives to PunishmentsSystemAll alternatives →