ControlBans
The moderation suite that doesn't compromise.
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.
⚡ Performance First
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.
🛡️ Punishment System
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.
🤖 AutoMod
Regex-based automated chat filtering that runs before any human has to act.
- Block — cancel the message and notify the player
- Shadow — message appears only to the sender and staff, silently logged
- Spam detection with configurable thresholds
- Caps normalization with bypass permissions per-rank
- Staff alerts on every triggered rule
💾 Database Support
Pick whatever fits your stack.
- MySQL / MariaDB / PostgreSQL — full relational support via HikariCP connection pooling
- MongoDB — NoSQL document storage
- SQLite / H2 — zero-config local file storage, perfect for single servers
Expired punishments are automatically purged on a configurable schedule. Your database won't rot after years of operation.
🔁 Redis Sync
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.
📦 Migrate From Another Plugin
Switching is a single command. ControlBans ships with a throttled, lag-safe importer for:
- LiteBans
- AdvancedBan
- Essentials
Run /cb import <source> and walk away.
🔌 Integrations
| 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 |
🌍 10 Languages
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.
🏗️ Built With
- Paper 1.20+ native API — no legacy hacks
- Folia supported — regionized multithreading compatible
- PacketEvents 2.x for packet-level operations
- Adventure / MiniMessage for all text rendering
- Caffeine for in-memory caching
- HikariCP for database connection pooling
📊 Stats
Discord · Source Code · Issues & Bug Reports
Made by tawny · Free forever · No premium tier
