{"id":35294,"date":"2026-06-01T20:05:18","date_gmt":"2026-06-01T17:05:18","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/"},"modified":"2026-06-01T20:05:18","modified_gmt":"2026-06-01T17:05:18","slug":"bubblebans","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/","title":{"rendered":"BubbleBans"},"content":{"rendered":"

BubbleBans is a lightweight, database-backed punishment plugin (bans, tempbans, mutes, warnings) for **Purpur\/Paper 1.21.10+**.<\/p>\n

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

## Optional integrations
\n– **PlaceholderAPI**: `%bubblebans_*%` placeholders
\n – `%bubblebans_muted%`, `%bubblebans_mute_reason%`, `%bubblebans_mute_expires%`, `%bubblebans_mute_remaining%`
\n – `%bubblebans_banned%`, `%bubblebans_ban_reason%`, `%bubblebans_ban_expires%`, `%bubblebans_ban_remaining%`
\n– **LuckPerms**: fills `` placeholder when available<\/p>\n

## Commands
\n– `\/ban [template|reason…]`
\n– `\/tempban [reason…]`
\n– `\/unban [reason…]`
\n– `\/mute [template|duration] [reason…]`
\n– `\/unmute [reason…]`
\n– `\/warn [reason…]`
\n– `\/history `
\n– `\/staffhistory `
\n– `\/rollback [confirm]`<\/p>\n

## Permissions
\n– `bubblebans.*` (default: op)
\n– `bubblebans.overwrite` (replace active ban\/mute)
\n– `bubblebans.notify.linked`<\/p>\n

## Setup
\n1) Drop the jar into `plugins\/` and start the server once.
\n2) Configure `config.yml`, `messages.yml`, and `templates.yml`.
\n3) Restart.<\/p>\n

**Note:** If you run multiple servers, enable `sync.enabled` and share the same database.<\/p>\n","protected":false},"excerpt":{"rendered":"

BubbleBans is a lightweight punishment plugin (bans, tempbans, mutes, warnings)<\/p>\n","protected":false},"featured_media":35295,"template":"","meta":{"_minecraft_slug":"bubblebans","_minecraft_project_id":"1slpGPPM","_minecraft_author":"ethan08921","_minecraft_license":"MIT","_minecraft_downloads":218,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bubblebans.zip","_minecraft_size_bytes":26482367,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T12:30:16.326762Z","_minecraft_date_created":"2026-01-04T05:02:21.778913Z","_minecraft_date_modified":"2026-02-25T11:04:14.472101Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bubblebans","_minecraft_icon_attachment_id":35295,"_minecraft_imported_at":"2026-06-01T17:05:20+00:00","_minecraft_import_hash":"578cdc71aa00f09b2cae037fb678eee1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-35294","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\nBubbleBans - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"BubbleBans - Minecraft\" \/>\n<meta property=\"og:description\" content=\"BubbleBans is a lightweight punishment plugin (bans, tempbans, mutes, warnings)\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bubblebans\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bubblebans\\\/\",\"name\":\"BubbleBans - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bubblebans\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bubblebans\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/bubblebans-icon-c6f5a302c6b5d41a27dda7ac463f453302d2c0b7_96.webp\",\"datePublished\":\"2026-06-01T17:05:18+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bubblebans\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bubblebans\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bubblebans\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/bubblebans-icon-c6f5a302c6b5d41a27dda7ac463f453302d2c0b7_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/bubblebans-icon-c6f5a302c6b5d41a27dda7ac463f453302d2c0b7_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/bubblebans\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"BubbleBans\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"BubbleBans - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/","og_locale":"en_US","og_type":"article","og_title":"BubbleBans - Minecraft","og_description":"BubbleBans is a lightweight punishment plugin (bans, tempbans, mutes, warnings)","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/","name":"BubbleBans - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/bubblebans-icon-c6f5a302c6b5d41a27dda7ac463f453302d2c0b7_96.webp","datePublished":"2026-06-01T17:05:18+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/bubblebans-icon-c6f5a302c6b5d41a27dda7ac463f453302d2c0b7_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/bubblebans-icon-c6f5a302c6b5d41a27dda7ac463f453302d2c0b7_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/bubblebans\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"BubbleBans"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/35294","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/35295"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=35294"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=35294"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=35294"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=35294"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}