Bad Bans

--- <div align="center"> # 🛡️ BadBans ### ⚡ Modern Zero-Lag Punishment System for Paper Servers **BadBans** is a lightweight, powerful and modern punishment plugin built for Minecraft Paper servers. Manage punishments, IP tracking, dupe IP checks, staff tools, web history and multi-server sync with a clean and fast system. <br> !(https://img.shields.io/badge/Paper-26.1.2-red?style=for-the-badge) !(https://img.shields.io/badge/Java-25+-orange?style=for-the-badge) !(https://img.shields.io/badge/Storage-MariaDB%20%2F%20SQLite-blue?style=for-the-badge) !(https://img.shields.io/badge/Sync-Redis-critical?style=for-the-badge) !(https://img.shields.io/badge/Author-Bad__0320-black?style=for-the-badge) <br> **Author:** `Bad_0320` **Platform:** `Paper` **Minecraft:** `26.1.2` **Java:** `25+` **Storage:** `MariaDB / SQLite` **Sync:** `Redis` </div> --- ## ✨ Overview **BadBans** is a complete punishment system inspired by LiteBans, designed for modern Minecraft servers that need clean moderation tools, fast database handling and reliable staff control. It includes **bans, IP bans, mutes, IP mutes, warnings, kicks, dupe IP checks, history lookup, silent punishments, rollback tools, web history support and optional player wipe systems**. > **Built to punish players, not your TPS.** --- ## 🚀 Feature Highlights <table> <tr> <td width="50%"> ### 🛑 Punishment System Everything needed to manage player punishments in a clean and reliable way. * Account bans * Temporary bans * IP bans * Temporary IP bans * Mutes * Temporary mutes * IP mutes * Warnings * Temporary warnings * Kicks * Kick all </td> <td width="50%"> ### 🔍 Staff Investigation Tools Powerful tools to track players, IPs, punishments and linked accounts. * Full punishment history * Active punishment check * IP history * Dupe IP scanner * UUID tracking * IP tracking * Status-colored alt accounts * Pretty punishment IDs * Staff rollback system </td> </tr> <tr> <td width="50%"> ### 🌐 Network Ready Designed for both single servers and multi-server networks. * MariaDB support * Redis synchronization * SQLite fallback * Multi-server punishment sync * Safe fallback behavior * Runtime library loading * Lightweight final jar </td> <td width="50%"> ### 🎨 Premium Experience Clean visuals, polished messages and smooth staff feedback. * Small caps punishment screens * Styled ban messages * Styled mute messages * Clean public broadcasts * Silent staff notifications * XP orb success sound * Tab completion * Web history support </td> </tr> </table> --- ## ⚡ Zero-Lag Design BadBans is designed to keep your server smooth, even during active moderation. Database operations, punishment checks and sync actions are handled asynchronously where possible, reducing main-thread work and helping protect server TPS. | Design Goal | Result | | ------------------------- | ------------------------- | | Async punishment handling | Less main-thread pressure | | Database work off-thread | Better server performance | | Redis synchronization | Fast network-wide updates | | Lightweight jar | Faster deployment | | Paper API usage | Better compatibility | | No NMS dependency | Easier updates | --- ## 🌐 Multi-Server Support BadBans is ready for server networks and shared punishment data. | Component | Purpose | | ----------- | ------------------------------------------ | | **MariaDB** | Main source of truth for punishment data | | **Redis** | Real-time synchronization between servers | | **SQLite** | Local fallback when MariaDB is unavailable | If MariaDB or Redis are not available, BadBans can safely fall back to SQLite and disable multi-server sync automatically. --- ## 🔇 Silent Punishments Every punishment command supports silent mode using `-s`. | Example | Visibility | | ---------------------------- | --------------------------------------------------- | | `/ban Player 7d Cheating` | Visible to everyone online | | `/ban Player 7d Cheating -s` | Visible only to staff with silent notify permission | Silent notifications are shown only to console and players with: `badbans.notify.silent` --- ## ⚠️ Warning Auto-Ban BadBans includes an automatic warning punishment system. | Setting | Default | | ------------------------ | --------------------------- | | Active warnings required | `3` | | Automatic action | `Ban` | | Duration | `1 day` | | Reason | `Too many warnings reached` | When a player reaches the configured warning limit, BadBans automatically applies the punishment. --- ## 🧹 Wipe System BadBans includes a powerful player reset system. `/w