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 - PlaceholderAPI: `%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 `` placeholder when available

## Commands - `/ban ` - `/tempban ` - `/unban ` - `/mute ` - `/unmute ` - `/warn ` - `/history ` - `/staffhistory ` - `/rollback `

## 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.