ControlBans

ControlBans is one of my plugins that I enjoy working on the most. I created it in late 2025 and I've been updating it and putting it first ever since. I do plan on releasing more plugins eventually, but that's besides the point.

I made ControlBans because I was tired of moderation plugins that lock everything useful behind a premium tier. This one is free and open source, and everything on this page works the moment you drop the jar in. No paid commands, no cut down version, no catch.

What it does

ControlBans is a full moderation suite. Punishments, reports, appeals, chat management, alt detection, voice chat mutes, and staff tools, all running async so your server never stutters when someone gets banned.

It works on Paper, Folia, BungeeCord, and Velocity, and if you run a network you can hook it up to Redis and every ban, mute, and unban syncs across all your servers the instant it happens.

Commands

Punishments

Command	Description
/ban, /tempban, /unban	Ban players permanently or for a set time
/mute, /tempmute, /unmute	Mute players permanently or for a set time
/shadowmute	The player sees their own messages. Nobody else does
/ipban, /ipmute, /unipban	Punish by IP address
/warn	Warn a player, with configurable escalation templates
/kick	Kick a player with a reason
/freeze	Freeze a player for screenshare. Auto bans if they log out
/voidjail, /unvoidjail	Trap a player in an inescapable void dimension
/banskin, /unbanskin	Force a player's skin back to default
/voicemute, /tempvoicemute	Mute players in Simple Voice Chat

Staff tools

Command	Description
/punish	Click through GUI for quick punishments
/history	Full punishment timeline for any player
/check	Look up a player's status
/alts	Detect alt accounts sharing an IP
/note	Private staff notes on a player
/banlist, /mutelist	Browse active punishments
/blame	See which staff member did what
/reports	Staff report GUI: view every report, filter by status, read full descriptions, teleport to the reporter or reported player with a click, and resolve, reject, reopen, or delete
/appeals	Staff appeal review GUI: read mute appeals and approve (auto unmutes) or deny
/chat lock, /chat slow, /chat clear	Chat management
/staff	See which staff are online

For players

Command	Description
/report	Report a player through a GUI. Staff fully control the categories in the config (icons, names, descriptions) or players can write their own reason
/reports	Check the status of your own reports
/appeal	Appeal a mute in game

Every staff command supports -s for silent punishments. Staff with the silent notify permission see it, everyone else doesn't.

AutoMod

Regex based chat filtering that runs before any human has to step in. Block messages, shadow them so only staff see them, detect spam, and normalize caps. Every rule is configurable with staff alerts.

Databases

SQLite by default, which means drag and drop. You don't have to connect to anything, just put the jar in your plugins folder and it works. If you want more, MySQL and MariaDB are fully supported through HikariCP, and Redis handles network sync. Expired punishments get cleaned out automatically on a schedule so your database never rots.

Switching from another plugin? There's a built in importer for LiteBans, AdvancedBan, and Essentials. One command, /cb import, done.

Integrations

• Simple Voice Chat: /voicemute and /tempvoicemute mute players in proximity voice, fully synced with normal mutes
• DiscordSRV: punishment alerts post to your Discord channels automatically
• Floodgate/Geyser: Bedrock players are detected and handled correctly

There's also a public API if you make plugins and want to hook into everything ControlBans does.

Themes

The messages can look like whatever you want. Every single message is MiniMessage formatted and configurable, and the jar ships with premade theme packs in themes/ styled after servers like Hypixel, minemen, and mcpvp(.club) if you want that look without doing the work yourself.

Languages

English, German, Spanish, French, Italian, Japanese, Dutch, Portuguese, Russian, and Turkish, all included.

Stats

---

Discord · Source Code · Issues

Made by tawny.