Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for SyntaxDevTeam

Advanced punishment system for Minecraft servers with warnings, mutes, bans, kicks and more.

Report PunisherX?

Snapshot
1.6.1-SNAPSHOT

WieszczY released PunisherX version 1.6.1-SNAPSHOT on January 30, 2026

Changelog

Functional changes

  • Added 2 new placeholders punishment_history_list and active_punishments_list
  • Added support for /reload and /minecraft:reload commands
  • Added customization for Discord Webhook (#62)
# Discord webhook settings.
webhook:
  discord:
    enabled: false
    url: "YOUR_WEBHOOK_URL_HERE"
    username: ""
    avatar-url: "" # URL, Minecraft nick/UUID (mc-heads), or base64 PNG data
    colors:
      # Accepts integers (Discord decimal), hex with #/0x, or common names like red/orange/blue/black/white.
      ban: 9447935
      mute: 15158332
      warn: 16753920
      kick: 16776960
      jail: 9447935
      default: 8421504
    embed:
      title: "Event Title"
      description: "Administrator {operator} {type} {player} for {reason} for {time}"
      url: "https://example.com"
      timestamp: "" # ISO-8601 or "now" for current time
      thumbnail-url: "" # URL, Minecraft nick/UUID, or base64 PNG data
      image-url: "" # URL, Minecraft nick/UUID, or base64 PNG data
      author:
        name: "Author Name"
        icon-url: "" # URL, Minecraft nick/UUID, or base64 PNG data
      footer:
        text: "Footer text"
        icon-url: "" # URL, Minecraft nick/UUID, or base64 PNG data
      fields:
        - name: "Player"
          value: "{player}"
          inline: true
        - name: "Operator"
          value: "{operator}"
          inline: true
        - name: "Type"
          value: "{type}"
          inline: true
        - name: "Reason"
          value: "{reason}"
          inline: false
        - name: "Time"
          value: "{time}"
          inline: true
        - name: "ID"
          value: "{id}"
          inline: true
  • Added basics placeholders to Discord webhooks
  • Added penalty ID to notification message
  • Added server-scoped punishment filtering - full support
# If your server is on a server network, such as Velocity,
# set the mode name to associate any penalties issued with that specific server.
# This means that a penalty received on a server like Survival will not be applied to games like SkyBlock, etc.
# The default setting is "network" and means that the penalty received will apply to all servers on the network.
server: "network"

Technical changes:

  • Added LeavesMC support
  • Added the ability to restore cache entries for jail from the database.
  • Added backup for MC-Head without access
  • Refactor duplicated code in command files
  • Added protection against unfinished database connection
  • Fixed addPunishment argument in DatabaseHandler
  • Updated all dependencies and libraries

Bug fixes:

  • HOTFIX: Fixed jail system unjailing issue (#65)
  • HOTFIX: Fixed warning limit configuration (#66)
  • HOTFIX: Fixed IllegalStateException error
  • HOTFIX: Fixed unexpected error on /prx reload
  • HOTFIX: Fixed issue with command re-registration after /prx reload
  • HOTFIX: Fixed /prx reload command on Folia
  • HOTFIX: Fixed webhook<->permissions correlations
  • Fixed argument suggestions for punishes commands
  • Fixed permission key for panel command access

Experimental:

  • Access to experimental commands has been completely removed until further work is done.

Information

Published onJanuary 30, 2026
Downloads5

Platforms

Paper Paper (1.20.6-1.21.11)