BetterBan – Advanced Ban & Chat Management for Servers

BetterBan is a powerful moderation plugin for Paper, Spigot, Bukkit, and Folia servers, replacing traditional bans with an advanced system and seamless Discord integration.

Main Features

1. Enhanced Ban System

Temporary and permanent bans.
Optional reason for every ban.
Clear Discord logging for all moderation actions.
Automatic expiration of temporary bans.

2. Full Chat-Ban (Mute) System

Completely separate from normal bans, allowing players to stay online but mute their chat.
/chatban command with duration support (m, h, d) and permanent option.
/chatunban command to lift chat-bans.
/chatbanlist command to view all active chat-bans with remaining time or permanent status.
Automatic prevention of chat messages for muted players with informative messages.
Discord webhook notifications for chat-ban and unmute events.

3. Complete Player Management

UUID-based system prevents errors when players change nicknames.
Easy overview of all banned and chat-banned players.
Quick unban functionality.

4. Commands

/ban <player> <reason> – Ban a player. Permission: betterban.ban
/tempban <player> <duration> <reason> – Temporary ban. Permission: betterban.tempban
/unban <player> – Lift a ban. Permission: betterban.unban
/banlist – Display all banned players. Permission: betterban.banlist
/chatban <player> <duration|permanent> [reason] – Mute a player in chat. Permission: betterban.chatban
/chatunban <player> – Lift a chat-ban. Permission: betterban.chatunban
/chatbanlist – Display all chat-banned players. Permission: betterban.chatbanlist
/kick <player> <reason> – Kick a player. Permission: betterban.kick

5. Discord Integration

Automatic notifications for bans, unbans, tempbans, chat-bans, chat-unbans, and kicks.
Link to a Discord channel for fast moderator communication.
Configure the Discord webhook URL in config.yml.

6. Moderation & Admin Features

Admins can lift all active bans and chat-bans.
Clear console and in-game messages for moderators.
Temporary bans and chat-bans expire automatically.

7. Easy Installation & Configuration

No external dependencies except Paper, Spigot, Bukkit, or Folia.
Supports Minecraft versions from 1.8.8 up to 1.21.11.
Config files are automatically created on first run.
Customizable messages, ban reasons, and Discord settings.

Benefits

Simple and fast moderation workflow.
UUID-based: reliable even if players change nicknames.
Separate chat-bans allow flexible moderation without kicking players.
Transparent management with Discord notifications.
Optimized for Paper, Spigot, Bukkit, and Folia servers.

Developer Notes

Discord: https://discord.gg/2rkPqrnBC5
GitHub: https://github.com/Jakomi1/BetterBan
Author: Jakomi1

Better Ban