BetterBan – Advanced Moderation System for Minecraft Servers
BetterBan is a powerful moderation plugin for Paper, Spigot, Bukkit, and Folia servers. It provides a complete system for managing bans, chat mutes, voice moderation, and Discord integration in one unified solution.
Main Features
🔨 Ban System
- Temporary and permanent bans
- Optional reasons for all bans
- Automatic expiration of temporary bans
- UUID-based tracking for reliable identification
- Instant player removal on ban
- Full moderation logging via Discord
💬 Chat Moderation System
- Mute players without removing them from the server
- Temporary and permanent chat bans
- Automatic blocking of all chat messages for muted players
- Clear feedback messages for affected players
- Independent from normal ban system
🎙 Voice Chat Moderation
- Voice bans with temporary and permanent options
- Independent control from game and chat bans
- Automatic removal from voice communication
- Integration with voice chat systems
🔔 Discord Integration
- Automatic webhook notifications for all moderation actions
- Logs for bans, unbans, kicks, chat bans, and voice bans
- Improves staff communication and transparency
Commands
📌 Ban Commands
- /ban <player> [reason] – Permanently ban a player
- /tempban <player> <time> [reason] – Temporarily ban a player (e.g. 10m, 2h, 1d)
- /unban <player> – Remove a ban
- /banlist – Show all active bans
💬 Chat Commands
- /chatban <player> <time|permanent> [reason] – Mute a player’s chat
- /chatunban <player> – Remove chat mute
- /chatbanlist – Show all active chat bans
⚡ Utility Commands
- /kick <player> [reason] – Kick a player from the server
🎙 Voice Commands
- /voiceban <player> <time|permanent> [reason] – Mute voice chat
- /voiceunban <player> – Remove voice ban
- /voicebanlist – Show all active voice bans
Why BetterBan?
- All-in-one moderation system
- Clear separation between bans, chat, and voice moderation
- Fast and efficient staff workflow
- Reliable UUID-based player handling
- Perfect for small and large Minecraft communities
Links
- Discord: https://discord.gg/2rkPqrnBC5
- GitHub: https://github.com/Jakomi1/BetterBan
- Author: Jakomi1
All Versions
+ Add Version<li>fixed package name</li>
</ul>
<li>fixed language bug</li>
</ul>
- added language file support in plugins/BetterBan/lang/
- improved config.yml data control system
- updated and changed message format
- added webhook-language to independently control webhook language separate from player feedback language
- fixed discord format-bug for VoiceBan and ChatBan
- added voiceban/voiceunban/voicebanlist
- removed unused code
- added auto description update
- register command & permissions dynamically
- changed permission from betterban.chatban to betterban.chat.ban
- added fastStats support
- added universal plugin releaser
- added SimpleVoiceChat detection
- added SVC soft-depend
- added bStats
- added autoRelease option
<ul>
<li>Full chat-ban (mute) system completely separate from normal bans.</li>
<li>/chatban command with duration support (m, h, d) and permanent option.</li>
<li>/chatunban command to remove chat-bans.</li>
<li>/chatbanlist command to view all active chat-bans.</li>
<li>ChatBanUtils with dedicated database table, cache, and expiration handling.</li>
<li>Discord webhook integration for chat-ban and chat-unban events.</li>
<li>Automatic prevention of chat messages for chat-banned players.</li>
<li>Full compatibility with Bukkit, Spigot, Paper, and Folia.</li>
<li>Support for all Minecraft versions from 1.8.8 up to 1.21.11.</li>
</ul>
<h3>🛠️ Changed</h3>
<ul>
<li>Improved moderation system structure by separating bans and chat-bans internally.</li>
<li>Optimized cache handling for faster chat-ban checks.</li>
<li>Improved cross-version compatibility layer for consistent behavior across all supported server platforms.</li>
</ul>
<h3>🐛 Fixed</h3>
<ul>
<li>Ensured chat-banned players can no longer send any chat messages.</li>
<li>Fixed potential cache inconsistencies when chat-bans expire.</li>
</ul>
<ul>
<li>Folia compatibility for running on Folia server implementations.</li>
</ul>
<h3>🛠️ Changed</h3>
<ul>
<li>Updated Bukkit and Spigot compatibility for stable execution on multiple server versions.</li>
</ul>
<h3>🐛 Fixed</h3>
<ul>
<li>Discord webhook messages for temporary bans now display correctly.</li>
</ul>
<ul>
<li>Temporary and permanent ban system with optional reasons for each ban.</li>
<li>UUID-based player management to prevent errors when players change nicknames.</li>
<li>Commands: <code>/ban</code>, <code>/tempban</code>, <code>/unban</code>, <code>/kick</code>, and <code>/banlist</code> with proper permissions.</li>
<li>Automatic Discord notifications for bans, unbans, tempbans, and kicks.</li>
<li>Configurable Discord webhook URL in <code>config.yml</code> for easy integration.</li>
<li>Automatic creation of config files on first run with customizable messages, ban reasons, and Discord settings.</li>
</ul>
<h3>🛠️ Changed</h3>
<ul>
<li>Console and in-game messages are now clear and easy to read for moderators and admins.</li>
<li>Temporary bans now expire automatically at the correct time.</li>
<li>Admin commands allow lifting all active bans efficiently.</li>
</ul>
<h3>🐛 Fixed</h3>
<ul>
<li>Ban actions now reliably handle UUIDs, preventing issues with nickname changes.</li>
<li>Discord logging now correctly reports all moderation actions without missing events.</li>
</ul>