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