ModsJava
xPunish
A GUI-driven staff punishment plugin for Paper 1.20+ with rank-based permissions, auto-escalating mutes & bans, full audit logging, and Discord webhook…
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.
xPunish is a GUI-driven moderation plugin built exclusively for Paper 1.20.4+. It gives your staff team a clean, rank-aware punishment interface with automatic escalation, a full audit trail, and a complete set of chat shortcut commands — no config bloat, no database required.
📖 Read the Full Documentation Here
Key features:
- Inventory GUI — warn, kick, mute, and ban from a single /punish command; buttons hide automatically based on the staff member's rank
- Chat shortcuts — /warn, /kick, /tempmute, /tempban, and /unmute for experienced staff who prefer speed over menus
- Auto-escalation — separate mute and ban strike tracks with fully configurable duration tiers (3h → 6h → 1d → 3d → 1w → permanent)
- Paginated history — /history shows a full colour-coded punishment record across multiple pages
- Staff audit log — /stafflog shows every punishment a specific staff member has ever issued
- Rank protection — staff cannot punish players of equal or higher rank
- Custom reasons — every reason menu includes a "✎ Custom Reason..." option letting staff type a freeform reason directly in chat
- Mute expiry notifications — players are notified the moment their mute expires while online
- Discord webhook — every punishment fires an embed to your moderation channel automatically
- Live reload — /xpunish reload applies all config, rank, and message changes with no restart Requirements: Paper 1.20.4+ · No dependencies · YAML storage · LuckPerms recommended for rank assignment
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 26.1, 26.1.1, 26.1.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as xPunish-26.x.jar — drop this file into the mods folder
- Download size: 58 KB
- Download link checked 24 Aug 2026 — working
These come from our own check of the pack file, not from the source page.