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. - **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 !(https://bstats.org/signatures/bukkit/ControlBans.svg) --- **(https://discord.com/invite/AnQvddTZDg)** · **(https://github.com/TawnyE/Controlbans)** · **(https://github.com/TawnyE/Controlbans/issues)** > Made by (https://modrinth.com/user/tawny) · Free forever · No premium tier >