Перейти к содержимому
Mineforgian

PunisherXX

A plugin used for easy server moderation, fully customisable and easy to use.

Загрузки
49
Подписчики
1
Обновлён
14 апреля 2026 г.
Лицензия
MIT

Опубликован 13 апреля 2026 г.

Исходный кодСообщить об ошибке

PunisherXX

PunisherXX is a configurable punishment plugin for Paper 1.21.x focused on fast moderation workflows.

It supports custom punish types, warning escalation, and built-in ban, kick, and mute logic, while keeping everything editable in config.

Why PunisherXX

  • Config-driven punish flows for different rule breaks
  • Built-in action keywords for warning, kicking, banning, and muting
  • Warning escalation rules (example: 3 warnings -> temporary ban)
  • Timed punishments with human-friendly durations like 30m, 12h, 7d, 2w, or perm
  • Permission-node friendly design for LuckPerms and similar permission plugins
  • Persistent punishment data stored in data.yml

Commands

  • /punish [reason]
  • /punish reload
  • /warn [time] [reason]
  • /pban [reason]
  • /pkick [reason]
  • /pmute [reason]

Permissions

Default nodes:

  • punisher.punish
  • punisher.warn
  • punisher.ban
  • punisher.kick
  • punisher.mute
  • punisher.reload

Dynamic node template:

  • punisher.punish.%type%

You can fully customize node names in config.yml.

Config Style

Define punish types as either direct action lists or structured blocks with custom permissions.

Example:

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.

Placeholders

Common placeholders in actions and messages:

  • %player%
  • %reason%
  • %type%
  • %actor%
  • %duration%
  • %count%

Compatibility

  • Server software: Paper (1.21.x)
  • Java: 21

Install

  1. Build the plugin or download the release jar.
  2. Put the jar into your server plugins folder.
  3. Start the server once to generate config files.
  4. Edit config.yml for your punish logic and permissions.
  5. Use /punish reload after changes.

Notes

PunisherXX is intended for server staff moderation. Review your punish commands and escalation thresholds before using in production.

Ченджлог

1.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 14 апреля 2026 г.

PunisherXX 1.2.1

In this update we have changed the file version checks so if this plugin finds that you have outdated config version it saves the previous config elsewhere and makes a new config

1.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 13 апреля 2026 г.

PunisherXX 1.2.0

added unban and unmute features

1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 13 апреля 2026 г.

PunisherXX

This is the first release for PunisherXX that adds essential punishments and is fully customisable. Also in this version we added /punish as a shortcut for a multiple command execution, for example /clear, /kill and /ban %player% so whenever the player rejoins after a ban they have to start from 0 with no cheated items.

Комментарии

Загружаем…