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