# ControlBans
\n### The moderation suite that doesn’t compromise.<\/p>\n
Free. Open source. Built for networks that actually care about performance.<\/p>\n
ControlBans is a fully async, production-hardened punishment system for Paper, Folia, BungeeCord, and Velocity. No premium tier. No paywalled commands. The whole thing \u2014 source code and all \u2014 is right here.<\/p>\n
—<\/p>\n
## \u26a1 Performance First<\/p>\n
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 \u2014 join checks, mute enforcement, alt detection \u2014 never hit storage twice.<\/p>\n
—<\/p>\n
## \ud83d\udee1\ufe0f Punishment System<\/p>\n
A complete moderation toolkit, no third-party dependencies required.<\/p>\n
| Command | Description |
\n|—|—|
\n| `\/ban`, `\/tempban`, `\/unban` | Permanent and temporary bans |
\n| `\/mute`, `\/tempmute`, `\/unmute` | Permanent and temporary mutes |
\n| `\/shadowmute` | Player sees their own messages. Nobody else does. |
\n| `\/ipmute`, `\/ipmute`, `\/unipban` | IP-level bans and mutes |
\n| `\/warn` | Warns with configurable escalation templates |
\n| `\/kick` | Kick with reason and silent flag |
\n| `\/note` | Private staff notes attached to a player profile |
\n| `\/freeze` | Lock a player in place for screenshare \u2014 auto-bans on quit |
\n| `\/voidjail`, `\/unvoidjail` | Trap players in an inescapable void dimension |
\n| `\/banskin`, `\/unbanskin` | Force-revert inappropriate skins to default instantly |
\n| `\/voicemute`, `\/tempvoicemute` | Mute players natively in **Simple Voice Chat** |
\n| `\/punish` | Click-through GUI for quick punishments without typing |
\n| `\/history`, `\/check`, `\/alts` | Player lookup, punishment timeline, alt account detection |
\n| `\/banlist`, `\/mutelist`, `\/blame` | Browse active punishments and staff activity |
\n| `\/report`, `\/reports` | Player reports with staff resolution workflow |
\n| `\/appeal` | In-game mute appeals with cooldown + submission limits |
\n| `\/chat lock`, `\/chat slow`, `\/chat clear` | Global chat management |
\n| `\/staff` | View currently online staff members |<\/p>\n
All commands support a `-s` silent flag. Staff with `controlbans.notify.silent` see the action \u2014 nobody else does.<\/p>\n
—<\/p>\n
## \ud83e\udd16 AutoMod<\/p>\n
Regex-based automated chat filtering that runs before any human has to act.<\/p>\n
– **Block** \u2014 cancel the message and notify the player
\n– **Shadow** \u2014 message appears only to the sender and staff, silently logged
\n– Spam detection with configurable thresholds
\n– Caps normalization with bypass permissions per-rank
\n– Staff alerts on every triggered rule<\/p>\n
—<\/p>\n
## \ud83d\udcbe Database Support<\/p>\n
Pick whatever fits your stack.<\/p>\n
– **MySQL \/ MariaDB \/ PostgreSQL** \u2014 full relational support via HikariCP connection pooling
\n– **MongoDB** \u2014 NoSQL document storage
\n– **SQLite \/ H2** \u2014 zero-config local file storage, perfect for single servers<\/p>\n
Expired punishments are automatically purged on a configurable schedule. Your database won’t rot after years of operation.<\/p>\n
—<\/p>\n
## \ud83d\udd01 Redis Sync<\/p>\n
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.<\/p>\n
Supports both **BungeeCord** and **Velocity**.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Migrate From Another Plugin<\/p>\n
Switching is a single command. ControlBans ships with a throttled, lag-safe importer for:<\/p>\n
– **LiteBans**
\n– **AdvancedBan**
\n– **Essentials**<\/p>\n
Run `\/cb import —<\/p>\n ## \ud83d\udd0c Integrations<\/p>\n | Integration | What it does | —<\/p>\n ## \ud83c\udf0d 10 Languages<\/p>\n 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.<\/p>\n —<\/p>\n ## \ud83c\udfd7\ufe0f Built With<\/p>\n – **Paper 1.20+** native API \u2014 no legacy hacks —<\/p>\n ## \ud83d\udcca Stats<\/p>\n <\/p>\n —<\/p>\n **Discord** \u00b7 **Source Code** \u00b7 **Issues & Bug Reports**<\/p>\n > Made by tawny \u00b7 Free forever \u00b7 No premium tier Feature compact punishment system. free and open sourced.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"controlbans","_minecraft_project_id":"2V1taxea","_minecraft_author":"Tawny","_minecraft_license":"MIT","_minecraft_downloads":394,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"controlbans.zip","_minecraft_size_bytes":327334804,"_minecraft_version_count":12,"_minecraft_updated_at":"2026-05-16T11:01:56.337988Z","_minecraft_date_created":"2025-10-22T21:55:17.495472Z","_minecraft_date_modified":"2026-05-14T06:23:24.492089Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/controlbans","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-02T06:03:09+00:00","_minecraft_import_hash":"174565a0e4fed7aad1308e372664f662","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,125,126,127,128,129,92,985],"mod_loader":[130,895,131,132,133,134,986],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-45565","mod","type-mod","status-publish","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_category-velocity","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|—|—|
\n| **Simple Voice Chat** | `\/voicemute` silences players in proximity voice \u2014 fully synced |
\n| **DiscordSRV** | Punishment alerts forwarded to your Discord channels automatically |
\n| **Floodgate \/ Bedrock** | Bedrock players via Geyser are detected and handled correctly |<\/p>\n
\n– **Folia** supported \u2014 regionized multithreading compatible
\n– **PacketEvents 2.x** for packet-level operations
\n– **Adventure \/ MiniMessage** for all text rendering
\n– **Caffeine** for in-memory caching
\n– **HikariCP** for database connection pooling<\/p>\n
\n> <\/p>\n","protected":false},"excerpt":{"rendered":"