Compatibility
Minecraft: Java Edition
26.3
26.2
26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
Platforms
Tags
Creators
Details
Licensed MIT
Published 13 hours ago
Updated 3 weeks ago
⚡ xBan
The Next-Generation Punishment & Moderation Management Suite
xBan is an enterprise-grade, high-performance punishment and moderation suite built specifically for modern Minecraft networks. Engineered from the ground up for maximum throughput and zero main-thread overhead, xBan pairs frictionless in-game moderation with interactive Discord bot buttons, real-time in-memory caching, progressive penalty scaling, and custom paginated GUIs.
Whether running a community survival server or a competitive network with thousands of active players, xBan delivers professional-grade moderation tools with zero lag.
✨ Key Features
🚀 Zero Main-Thread Overhead & High-Speed Caching
- In-Memory Active Mute Cache: Zero database queries during player chat. Mute checks execute in sub-microsecond $O(1)$ memory lookups, completely eliminating chat latency and database lock contention.
- Asynchronous UUID Resolution: Offline player lookups never block the main server thread, preventing TPS drops from Mojang session server delays.
- Leak-Free GUI Architecture: Uses type-safe
InventoryHolderimplementations rather than title-string scraping, preventing memory leaks and event listener accumulation across reloads. - Dedicated Worker Pools: Fully decoupled thread pools with named daemon workers and automatic socket timeout guards prevent hung I/O threads.
🔨 Comprehensive Punishment Arsenal
- Permanent & Temporary Bans (
/ban,/tempban) - Permanent & Temporary Mutes (
/mute,/tempmute) - Permanent & Temporary IP Bans (
/banip,/tempbanip) - Permanent & Temporary IP Mutes (
/muteip,/tempmuteip) - Server Kicks (
/kick) - Automatic IP Tracking & History: Stores player IP associations to prevent ban evasion automatically.
🤖 Interactive Discord Unban System
- Non-operator staff can submit unban requests in-game (
/unban <player> <reason>). - Requests instantly send to your Discord staff channel with interactive [Approve] and [Decline] buttons.
- Role verification ensures only staff with designated Discord roles can click buttons to unban players in real-time.
- Fallback webhook support when bot token is not configured.
📈 Progressive Offence Scaling
- Built-in infraction preset system (
/offend <player> <preset>). - Automatically queries the offender's history over the past 60 days and exponentially scales punishment duration ($2^n$) for repeat offenders.
- View offence breakdowns instantly with
/offences <player>.
🖥️ Interactive Paginated GUIs
- Player History GUI (
/history <player>): View active and expired punishments, issuing staff, dates, and unban reasons with clear terracotta status indicators. - Staff Logs GUI (
/staff logs <staff>): Audit staff activity and review moderation actions with ease.
💾 Dual Database Engine
- SQLite (Default): Embedded, high-speed database with WAL (Write-Ahead Logging) mode enabled for concurrent reads and writes with zero lag.
- MySQL / MariaDB: Connection-pooled via HikariCP for multi-server networks and cross-server synchronization.
🎨 Modern HEX & Small-Caps Aesthetics
- Fully customizable messages (
msg.yml) supporting native HEX RGB formatting (Bb2b2) and color codes. - Pre-configured with sleek, modern small-caps typography.
- Cached message formatting avoids redundant regex parsing.
📋 Commands & Permissions
| Command | Permission | Description |
|---|---|---|
/ban <player> [reason] |
xban.ban |
Permanently ban a player |
/tempban <player> <duration> [reason] |
xban.tempban |
Temporarily ban a player (e.g. 7d, 12h, 30m) |
/unban <player> [reason] |
xban.unban |
Directly unban (OPs) or submit an unban request |
/offend <player> <preset> |
xban.offend |
Apply a punishment preset with progressive duration scaling |
/offences <player> |
xban.offences |
View a player's recent offences over the past 2 months |
/mute <player> [reason] |
xban.mute |
Permanently mute a player in chat |
/tempmute <player> <duration> [reason] |
xban.tempmute |
Temporarily mute a player |
/unmute <player> |
xban.unmute |
Unmute a muted player |
/banip <player> [reason] |
xban.banip |
Permanently ban a player and their IP address |
/tempbanip <player> <duration> [reason] |
xban.tempbanip |
Temporarily IP-ban a player |
/unbanip <player> |
xban.unbanip |
Remove an IP ban for a player |
/muteip <player> [reason] |
xban.muteip |
Permanently IP-mute a player |
/tempmuteip <player> <duration> [reason] |
xban.tempmuteip |
Temporarily IP-mute a player |
/unmuteip <player> |
xban.unmuteip |
Remove an IP mute for a player |
/kick <player> [reason] |
xban.kick |
Kick a player from the server |
/history <player> |
xban.history |
Open the interactive GUI punishment history |
/staff logs <player> |
xban.stafflogs |
Open the interactive GUI staff punishment logs |
/unbanrequest list |
xban.unbanrequest |
List all pending in-game unban requests |
/unbanrequest approve <id> [reason] |
xban.unban.direct |
Approve a pending unban request |
/unbanrequest decline <id> [reason] |
xban.unban.direct |
Decline a pending unban request |
/xban reload |
xban.admin |
Reload config.yml and msg.yml configuration |
(Note: Legacy banx.* permission nodes and /banx aliases remain supported for backward compatibility).
⚙️ Quick Start & Configuration
- Drop
xban-1.0.0.jarinto your server'splugins/folder. - Restart your server to generate default configurations in
plugins/xBan/. - (Optional) Configure your Discord Bot or Webhook in
config.yml:
unban-requests:
enabled: true
webhook-url: "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
discord-bot:
enabled: true
token: "YOUR_DISCORD_BOT_TOKEN"
channel-id: "123456789012345678"
whitelisted-roles:
- "987654321098765432"
allow-server-admins: true


