Feature compact punishment system. free and open sourced.
Free. Open source. Built for networks that actually care about performance.
ControlBans is a fully async, production-hardened punishment system for Paper, Folia, BungeeCord, and Velocity. No premium tier. No paywalled commands. The whole thing — source code and all — is right here.
Every punishment, history lookup, and cache operation runs off the main thread via a CompletableFuture pipeline. Your TPS doesn't budge when a moderator bans someone. Caffeine caching sits in front of your database so repeat lookups — join checks, mute enforcement, alt detection — never hit storage twice.
A complete moderation toolkit, no third-party dependencies required.
| Command | Description |
|---|---|
/ban, /tempban, /unban |
Permanent and temporary bans |
/mute, /tempmute, /unmute |
Permanent and temporary mutes |
/shadowmute |
Player sees their own messages. Nobody else does. |
/ipmute, /ipmute, /unipban |
IP-level bans and mutes |
/warn |
Warns with configurable escalation templates |
/kick |
Kick with reason and silent flag |
/note |
Private staff notes attached to a player profile |
/freeze |
Lock a player in place for screenshare — auto-bans on quit |
/voidjail, /unvoidjail |
Trap players in an inescapable void dimension |
/banskin, /unbanskin |
Force-revert inappropriate skins to default instantly |
/voicemute, /tempvoicemute |
Mute players natively in Simple Voice Chat |
/punish |
Click-through GUI for quick punishments without typing |
/history, /check, /alts |
Player lookup, punishment timeline, alt account detection |
/banlist, /mutelist, /blame |
Browse active punishments and staff activity |
/report, /reports |
Player reports with staff resolution workflow |
/appeal |
In-game mute appeals with cooldown + submission limits |
/chat lock, /chat slow, /chat clear |
Global chat management |
/staff |
View currently online staff members |
All commands support a -s silent flag. Staff with controlbans.notify.silent see the action — nobody else does.
Regex-based automated chat filtering that runs before any human has to act.
Pick whatever fits your stack.
Expired punishments are automatically purged on a configurable schedule. Your database won't rot after years of operation.
Running a network? Configure Redis and bans, mutes, and unbans propagate across every node via Pub/Sub the instant they're issued. No polling. No delay.
Supports both BungeeCord and Velocity.
Switching is a single command. ControlBans ships with a throttled, lag-safe importer for:
Run /cb import <source> and walk away.
| Integration | What it does |
|---|---|
| Simple Voice Chat | /voicemute silences players in proximity voice — fully synced |
| DiscordSRV | Punishment alerts forwarded to your Discord channels automatically |
| Floodgate / Bedrock | Bedrock players via Geyser are detected and handled correctly |
Ships with full locale files for English, German, Spanish, French, Italian, Japanese, Dutch, Portuguese, Russian, and Turkish. Every message is MiniMessage-formatted and fully configurable.
Discord · Source Code · Issues & Bug Reports
Made by tawny · Free forever · No premium tier