BubbleBans

BubbleBans is a lightweight, database-backed punishment plugin (bans, tempbans, mutes, warnings) for Purpur/Paper 1.21.10+.

Features

- UUID-first punishments (offline targets supported) - Customizable ban kick screen with placeholders - Punishment templates / escalation ladders (ban & mute) - Warning categories with command triggers - History + staff history - Rollback by staff member - Multi-server sync (DB-backed broadcast events) - Multi-database support: H2 (default), MySQL, MariaDB, PostgreSQL - Linked-account detection (IP-based) + optional auto-ban - MiniMessage in messages (hex, hover/click supported by client)

Optional integrations

- LuckPerms: `%bubblebans_*%` placeholders - `%bubblebans_muted%`, `%bubblebans_mute_reason%`, `%bubblebans_mute_expires%`, `%bubblebans_mute_remaining%` - `%bubblebans_banned%`, `%bubblebans_ban_reason%`, `%bubblebans_ban_expires%`, `%bubblebans_ban_remaining%` - LuckPerms: fills `<staff_group>` placeholder when available

Commands

- `/ban <player> [template|reason...]` - `/tempban <player> <duration> [reason...]` - `/unban <player> [reason...]` - `/mute <player> [template|duration] [reason...]` - `/unmute <player> [reason...]` - `/warn <player> <category> [reason...]` - `/history <player>` - `/staffhistory <staff>` - `/rollback <staff> [confirm]`

Permissions

- `bubblebans.*` (default: op) - `bubblebans.overwrite` (replace active ban/mute) - `bubblebans.notify.linked`

Setup

1) Drop the jar into `plugins/` and start the server once. 2) Configure `config.yml`, `messages.yml`, and `templates.yml`. 3) Restart.

Note: If you run multiple servers, enable `sync.enabled` and share the same database.