# BubblePerks<\/p>\n
**Version 2.0.0** – A modern, feature-rich perks system for Minecraft 1.21.8+ servers with native CoinsEngine support.<\/p>\n
A comprehensive perks system that allows players to purchase various upgrades and utility commands using in-game currency through an elegant GUI.<\/p>\n
## \u2728 Features<\/p>\n
– **Beautiful GUI**: Modern perks menu with gradient text, borders, and category sections
\n– **CoinsEngine Integration**: Native support for CoinsEngine v2.5.0+ with automatic currency detection
\n– **Vault Compatibility**: Seamless fallback to Vault economy systems
\n– **Multiple Perk Types**: Commands, upgrades, utilities, and progressive tiers
\n– **PlaceholderAPI Support**: Custom placeholders for integration with other plugins
\n– **Permission Integration**: Automatic permission granting via LuckPerms
\n– **Fully Configurable**: Customizable perks, costs, requirements, and rewards
\n– **Database Support**: SQLite and MySQL support for data persistence
\n– **Multi-tier Upgrades**: Progressive upgrade system for homes, vaults, and jobs<\/p>\n
## \ud83c\udfae Perk Categories<\/p>\n
### Utility Command Perks
\n– **Grindstone**: Access to `\/grindstone` command (virtual grindstone)
\n– **Workbench**: Access to `\/craft` command (virtual crafting table)
\n– **Anvil**: Access to `\/anvil` command (virtual anvil)
\n– **Ender Chest**: Access to `\/echest` command (virtual ender chest)
\n– **Cartography Table**: Access to `\/cartographytable` command (virtual cartography table)
\n– **Stonecutter**: Access to `\/stonecutter` command (virtual stonecutter)<\/p>\n
### Progressive Upgrade Perks
\n– **Homes**: Increase maximum home count (3 tiers: +3, +5, +7 homes)
\n– **Vaults**: Unlock additional vaults (3 tiers: +1, +1, +2 vaults)
\n– **Jobs**: Increase job slots (3 tiers: +1, +1, +1 job slots)<\/p>\n
## \ud83d\udccb Commands<\/p>\n
– `\/perks` – Open the perks GUI
\n– `\/perks help` – Show help information
\n– `\/perks reload` – Reload plugin configuration (admin only)<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
– `bubbleperks.use` – Basic access to perks system (default: true)
\n– `bubbleperks.admin` – Administrative access (default: op)
\n– `bubbleperks.bypass` – Bypass all perk requirements (default: false)<\/p>\n
## \ud83c\udff7\ufe0f Placeholders<\/p>\n
When PlaceholderAPI is installed, the following placeholders are available:<\/p>\n
– `%bubbleperks_has_ ## \ud83d\udce6 Dependencies<\/p>\n ### Required ### Optional ## \ud83d\ude80 Installation<\/p>\n 1. Download the latest release (`BubblePerks-2.0.0.jar`) ## \u2699\ufe0f Configuration<\/p>\n ### config.yml **Economy Settings (v2.0.0+)**: ### perks.yml ### messages.yml ## API Usage<\/p>\n “`java \/\/ Check if player has a perk \/\/ Get player’s perk level \/\/ Purchase a perk programmatically ## Support<\/p>\n For support, bug reports, or feature requests, please open an issue on the GitHub repository.<\/p>\n ## License<\/p>\n This project is licensed under the MIT License – see the LICENSE file for details.<\/p>\n","protected":false},"excerpt":{"rendered":" A modern, feature-rich perks system for Minecraft 1.21.8+ servers with native CoinsEngine support.<\/p>\n","protected":false},"featured_media":35323,"template":"","meta":{"_minecraft_slug":"bubbleperks","_minecraft_project_id":"ML4Eb4Cb","_minecraft_author":"ethan08921","_minecraft_license":"MIT","_minecraft_downloads":70,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bubbleperks.zip","_minecraft_size_bytes":31802,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:28:37.405372Z","_minecraft_date_created":"2025-12-17T23:37:06.668942Z","_minecraft_date_modified":"2025-12-15T17:14:39.267251Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bubbleperks","_minecraft_icon_attachment_id":35323,"_minecraft_imported_at":"2026-06-01T17:06:24+00:00","_minecraft_import_hash":"ba2ef985865f53effea44a66fa7596e6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,126,127,128,123,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-35322","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","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":"\n
\n– `%bubbleperks_level_
\n– `%bubbleperks_total_perks%` – Get total number of perks owned by player<\/p>\n
\n– **Vault** – Economy integration (fallback)
\n– **LuckPerms** – Permission management<\/p>\n
\n– **CoinsEngine** – Primary economy system (recommended, v2.5.0+)
\n– **PlaceholderAPI** – Placeholder support
\n– **Essentials** – Command perks integration & economy fallback
\n– **Jobs** – Job slot upgrades
\n– **AxVaults** – Vault upgrades<\/p>\n
\n2. Place the JAR file in your `plugins` folder
\n3. Install required dependencies:
\n – **Vault** (economy bridge)
\n – **LuckPerms** (permissions)
\n – **CoinsEngine** (recommended for currency) OR **Essentials** (economy fallback)
\n4. Restart your server
\n5. Configure the plugin files in `plugins\/BubblePerks\/`
\n6. Set your currency ID in `config.yml` under `economy.coinsengine-currency`
\n7. Reload with `\/perks reload`<\/p>\n
\nMain plugin configuration including economy settings, GUI options, and integrations.<\/p>\n
\n“`yaml
\neconomy:
\n currency-symbol: ‘\ud83e\udee7’
\n format-thousands: true
\n coinsengine-currency: ‘coins’ # Your CoinsEngine currency ID
\n use-coinsengine: true # Use CoinsEngine instead of Vault
\n“`<\/p>\n
\nDefine all available perks including costs, permissions, commands, and rewards.<\/p>\n
\nCustomize all plugin messages and text displayed to players.<\/p>\n
\n\/\/ Get the plugin instance
\nBubblePerks plugin = (BubblePerks) Bukkit.getPluginManager().getPlugin(“BubblePerks”);<\/p>\n
\nboolean hasPerk = plugin.getPerkManager().hasPlayerPurchased(player, “grindstone”);<\/p>\n
\nint level = plugin.getPerkManager().getPlayerPerkLevel(player, “homes_tier1”);<\/p>\n
\nboolean success = plugin.getPerkManager().purchasePerk(player, “workbench”);
\n“`<\/p>\n