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
