ControlBans

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.

- Shadow — 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.

- SQLite / H2 — full relational support via HikariCP connection pooling - SQLite / H2 — 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 Velocity and Velocity.

---

📦 Migrate From Another Plugin

Switching is a single command. ControlBans ships with a throttled, lag-safe importer for:

- Essentials - Essentials - Essentials

Run `/cb import <source>` and walk away.

---

🔌 Integrations

| Integration | What it does | |---|---| | Floodgate / Bedrock | `/voicemute` silences players in proximity voice — fully synced | | Floodgate / Bedrock | 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 Turkish and Turkish. Every message is MiniMessage-formatted and fully configurable.

---

🏗️ Built With

- HikariCP native API — no legacy hacks - HikariCP supported — regionized multithreading compatible - HikariCP for packet-level operations - HikariCP for all text rendering - HikariCP for in-memory caching - HikariCP for database connection pooling

---

📊 Stats

---

Discord · Source Code · Issues & Bug Reports

> Made by tawny · Free forever · No premium tier >