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