CasualBans

<div align="center"> # CasualBans **A modern, feature-rich cross-server punishment management system for Paper 1.21+** !(https://img.shields.io/badge/Paper-1.21--26.1.2-8c75a5?style=flat-square&logo=minecraft) !(https://img.shields.io/badge/Folia-✔-468ac9?style=flat-square) !(https://img.shields.io/badge/Java-21-46c98a?style=flat-square&logo=openjdk) !(https://img.shields.io/github/license/Kyssta-exe/CasualBans?style=flat-square&color=c98a46) !(https://img.shields.io/github/v/release/Kyssta-exe/CasualBans?style=flat-square&color=8c75a5) (https://kyssta-exe.github.io/casualbans) </div> --- CasualBans is the modern replacement for LiteBans, AdvancedBan, and similar punishment plugins. It's built from the ground up for Paper 1.21+ with cross-server sync, a powerful template system, Discord integration, and a clean developer API — all in a single zero-dependency JAR. ## Features - **8 Punishment Types** — Ban, TempBan, IP-Ban, Mute, TempMute, IP-Mute, Warn, Kick - **Cross-Server Sync** — Punishments, broadcasts, and notifications sync across all servers sharing a database - **3 Storage Backends** — JSON (default), H2, MySQL, MariaDB, PostgreSQL - **Template System** — Ladder-based punishment escalation with weighted template groups - **Staff Tools** — Rollback, history pruning, lockdown, mutechat, clearchat, staff notes - **Investigation Tools** — DupeIP alt detection, IP history, name history, last session, GeoIP - **Discord Webhooks** — Real-time notifications for punishments, alts, and staff actions - **Built-in Web Dashboard** — Dark-themed UI with live stats, search, and REST API - **Plugin Integrations** — PlaceholderAPI, ProtocolLib, Vault, LuckPerms - **Developer API** — Full `StorageProvider` + `PunishmentManager` for programmatic control - **Import System** — Migrate from LiteBans, AdvancedBan, Vanilla, or JSON - **Folia Support** — Fully compatible with regionized threading - **Command Flags** — `-s` silent, `-S` extra silent, `-p` public, `-m` modify, `-d` delete, `-I` IP - **Staff Groups** — Configurable groups with cooldowns, duration limits, and weight hierarchy - **Customizable Messages** — MiniMessage format with hex colors and gradients - **Zero Runtime Dependencies** — HikariCP, Gson, H2, MySQL, PostgreSQL drivers all bundled ## Quick Start ```bash # 1. Download the latest release # 2. Place CasualBans-<version>.jar in your plugins/ folder # 3. Start the server (config files auto-generate) # 4. Configure storage and features # 5. Start moderating ``` ```yaml # plugins/CasualBans/config.yml (essential settings) server: name: 'my-server' default-scope: '*' storage: driver: JSON # or MYSQL, MARIADB, POSTGRESQL, H2 ``` ## Commands | Command | Description | Permission | |---------|-------------|-----------| | `/ban <player> ` | Ban a player | `casualbans.ban` | | `/tempban <player> <duration> ` | Temporarily ban | `casualbans.tempban` | | `/ipban <player> ` | IP ban | `casualbans.ipban` | | `/mute <player> ` | Mute a player | `casualbans.mute` | | `/tempmute <player> <duration> ` | Temporarily mute | `casualbans.tempmute` | | `/warn <player> ` | Warn a player | `casualbans.warn` | | `/kick <player> ` | Kick a player | `casualbans.kick` | | `/unban <player> ` | Unban a player | `casualbans.unban` | | `/unmute <player> ` | Unmute a player | `casualbans.unmute` | | `/history <player> ` | View punishment history | `casualbans.history` | | `/checkban <player>` | Check ban status | `casualbans.checkban` | | `/banlist ` | List active bans | `casualbans.banlist` | | `/dupeip <player>` | Find alt accounts | `casualbans.dupeip` | | `/lockdown ` | Server lockdown | `casualbans.lockdown` | | `/mutechat ` | Toggle chat | `casualbans.mutechat` | | `/casualbans <reload\|import\|info>` | Admin commands | `casualbans.admin` | ## Permissions Overview | Category | Key Permissions | |----------|----------------| | Punishment | `casualbans.ban`, `.tempban`, `.ipban`, `.mute`, `.tempmute`, `.warn`, `.kick` | | Removal | `casualbans.unban`, `.unmute`, `.unwarn` (and `.own` variants) | | Investigation | `casualbans.history`, `.checkban`, `.banlist`, `.dupeip`, `.iphistory`, `.geoip` | | Staff Tools | `casualbans.lockdown`, `.mutechat`, `.clearchat`, `.staffrollback`, `.note` | | Notifications | `casualbans.notify`, `.notify.silent`, `.notify.broadcast` | | Exempt | `casualbans.exempt`, `.exempt.ban`, `.exempt.mute` | | Flags | `casualbans.silent`, `.extrasilent`, `.public`, `.modify`, `.delete` | | Admin | `casualbans.admin` | ## Configuration ```yaml # plugins/CasualBans/config.yml (abbreviated) server: name: 'casualbans' default-scope: '*' storage: driver: JSON sql: host: localhost port: 3306 database: casualbans username: root password: '' mutes: enabled: true comman