{"id":126218,"date":"2026-06-07T13:03:37","date_gmt":"2026-06-07T10:03:37","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/"},"modified":"2026-06-07T13:03:37","modified_gmt":"2026-06-07T10:03:37","slug":"punisherxx","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/","title":{"rendered":"PunisherXX"},"content":{"rendered":"

# PunisherXX<\/p>\n

PunisherXX is a configurable punishment plugin for Paper 1.21.x focused on fast moderation workflows.<\/p>\n

It supports custom punish types, warning escalation, and built-in ban, kick, and mute logic, while keeping everything editable in config.<\/p>\n

## Why PunisherXX<\/p>\n

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

## Commands<\/p>\n

– \/punish [reason]
\n– \/punish reload
\n– \/warn [time] [reason]
\n– \/pban

## Permissions<\/p>\n

Default nodes:<\/p>\n

– punisher.punish
\n– punisher.warn
\n– punisher.ban
\n– punisher.kick
\n– punisher.mute
\n– punisher.reload<\/p>\n

Dynamic node template:<\/p>\n

– punisher.punish.%type%<\/p>\n

You can fully customize node names in config.yml.<\/p>\n

## Config Style<\/p>\n

Define punish types as either direct action lists or structured blocks with custom permissions.<\/p>\n

Example:<\/p>\n

“`yml
\npunish:
\n xray:
\n permission: punisher.punish.xray
\n actions:
\n – “kill %player%”
\n – “clear %player%”
\n – “pban 30d %reason%”
\n“`<\/p>\n

Warning escalation example:<\/p>\n

“`yml
\nwarnings:
\n default-duration: 30d
\n escalation:
\n “3”:
\n duration: 7d
\n reason: Reached 3 active warnings.
\n “5”:
\n duration: 30d
\n reason: Reached 5 active warnings.
\n“`<\/p>\n

## Placeholders<\/p>\n

Common placeholders in actions and messages:<\/p>\n

– %player%
\n– %reason%
\n– %type%
\n– %actor%
\n– %duration%
\n– %count%<\/p>\n

## Compatibility<\/p>\n

– Server software: Paper (1.21.x)
\n– Java: 21<\/p>\n

## Install<\/p>\n

1. Build the plugin or download the release jar.
\n2. Put the jar into your server plugins folder.
\n3. Start the server once to generate config files.
\n4. Edit config.yml for your punish logic and permissions.
\n5. Use \/punish reload after changes.<\/p>\n

## Notes<\/p>\n

PunisherXX is intended for server staff moderation. Review your punish commands and escalation thresholds before using in production.<\/p>\n","protected":false},"excerpt":{"rendered":"

A plugin used for easy server moderation, fully customisable and easy to use.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"punisherxx","_minecraft_project_id":"S8G0QYPH","_minecraft_author":"dominik-kaspar-dev","_minecraft_license":"MIT","_minecraft_downloads":14,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"punisherxx.zip","_minecraft_size_bytes":127590,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T22:52:26.904541Z","_minecraft_date_created":"2026-04-17T03:12:45.877486Z","_minecraft_date_modified":"2026-04-14T06:47:19.367685Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/punisherxx","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T10:03:37+00:00","_minecraft_import_hash":"93ae8783be2989480e1cf71f40ff2213","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,92],"mod_loader":[130,132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-126218","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nPunisherXX - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PunisherXX - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A plugin used for easy server moderation, fully customisable and easy to use.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punisherxx\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punisherxx\\\/\",\"name\":\"PunisherXX - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"datePublished\":\"2026-06-07T10:03:37+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punisherxx\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punisherxx\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/punisherxx\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"PunisherXX\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PunisherXX - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/","og_locale":"en_US","og_type":"article","og_title":"PunisherXX - Minecraft","og_description":"A plugin used for easy server moderation, fully customisable and easy to use.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/","name":"PunisherXX - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"datePublished":"2026-06-07T10:03:37+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/punisherxx\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"PunisherXX"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/126218","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=126218"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=126218"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=126218"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=126218"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}