PunisherXX

PunisherXX is a Paper 1.21.x plugin with configurable punishment flows, warning escalation, and LuckPerms-friendly permission nodes.

Features

Config-driven /punish command with custom punishment types.
Built-in pban, pkick, pmute, and pwarn action keywords.
/warn <player> [time] [reason] with timed warnings.
Automatic escalation (example: 3 warnings => 7 day ban).
Built-in /pban, /pkick, and /pmute commands.
Persistent punishments in plugins/PunisherXX/data.yml.

Commands

/punish <type> <player> [reason]
/punish reload
/warn <player> [time] [reason]
/pban <player> <time> [reason]
/pkick <player> [reason]
/pmute <player> <time> [reason]

LuckPerms Permissions

All nodes are configurable in config.yml:

punisher.punish
punisher.punish.<type> (from template)
punisher.warn
punisher.ban
punisher.kick
punisher.mute
punisher.reload

Example Config Style (your requested format)

You can use direct command lists:

punish:
  xray:
    - "kill %player%"
    - "clear %player%"
    - "ban 30d %player% %reason%"

Or use built-in plugin logic actions:

punish:
  xray:
    permission: punisher.punish.xray
    actions:
      - "kill %player%"
      - "clear %player%"
      - "pban 30d %reason%"

Warning Escalation Example

warnings:
  default-duration: 30d
  escalation:
    "3":
      duration: 7d
      reason: Reached 3 active warnings.
    "5":
      duration: 30d
      reason: Reached 5 active warnings.

Build

From punisherXX directory:

..\apache-maven-3.9.14\bin\mvn -DskipTests package

Jar output should be in target/.