# BubbleRune – Advanced Rune System with Economy & Statistics<\/p>\n
**A feature-rich enchantment rune plugin with tier selection, dual-currency economy, SQLite statistics tracking, and extensive customization.**<\/p>\n
—<\/p>\n
## \ud83c\udfaf Overview<\/p>\n
BubbleRune transforms the traditional enchantment experience into an engaging progression system where players use **enchantment tables** as “Rune Tables” to roll for tiered rune items. Each rune can be revealed to obtain powerful EcoEnchants custom enchantments, creating a rewarding gameplay loop that encourages exploration, grinding, and strategic resource management.<\/p>\n
Unlike simple enchantment plugins, BubbleRune features:
\n– **Player choice** – Select which tier to roll from an interactive GUI
\n– **Dual-currency economy** – Costs both XP and BubbleCoins (CoinsEngine integration)
\n– **Persistent statistics** – SQLite database tracks every roll, player stats, and leaderboards
\n– **Progression systems** – Weekly quests, milestones, and rune combining mechanics
\n– **Visual polish** – Tier-specific particles, sounds, fireworks, and celebration effects<\/p>\n
Perfect for **survival servers**, **RPG servers**, and **economy-focused communities** looking to add depth to their enchantment system.<\/p>\n
—<\/p>\n
## \u2728 Key Features<\/p>\n
### \ud83c\udfb2 Tier-Based Rune System
\n**7 Distinct Tiers:** Common \u2192 Uncommon \u2192 Rare \u2192 Epic \u2192 Legendary \u2192 Special \u2192 Very Special<\/p>\n
Players interact with designated enchantment tables to open a GUI showing all 7 tiers. Each tier:
\n– Has configurable XP costs (min\/max ranges for variation)
\n– Has configurable BubbleCoin costs (separate per tier)
\n– Shows affordability indicators (colored wool when affordable, gray glass when not)
\n– Displays cost ranges, enchant counts, and player balances
\n– Glows when the player can afford it<\/p>\n
**Example Progression:**
\n“`
\nCommon: 1,000-2,000 XP + 1 coin \u2192 Basic enchants
\nUncommon: 3,000-5,000 XP + 2 coins \u2192 Better enchants
\nRare: 7,000-10,000 XP + 5 coins \u2192 Powerful enchants
\nEpic: 15,000-25,000 XP + 10 coins \u2192 Very powerful
\nLegendary: 50,000-75,000 XP + 25 coins \u2192 Rare enchants
\nSpecial: 100,000-150,000 XP + 50 coins \u2192 Ultra rare
\nVery Special: 250,000-500,000 XP + 100 coins \u2192 Exclusive enchants
\n“`<\/p>\n
### \ud83d\udcb0 Dual-Currency Economy System
\n**Seamless CoinsEngine Integration** (optional but recommended)<\/p>\n
Each tier can have its own BubbleCoin cost, creating meaningful economic decisions:
\n– **Low tiers** (1-5 coins) – Accessible for new players
\n– **High tiers** (25-100 coins) – Require dedicated farming\/trading
\n– **Configurable per tier** – Set any tier to 0 for XP-only rolling
\n– **Automatic refunds** – If rune creation fails, both XP and coins are refunded
\n– **Graceful degradation** – Plugin works without CoinsEngine (disables coin costs)<\/p>\n
The dual-currency system prevents XP-only farming and integrates with your existing economy, making runes a valuable server commodity.<\/p>\n
### \ud83d\udcca SQLite Database & Statistics
\n**Comprehensive Data Tracking**<\/p>\n
Every rune roll is permanently stored with:
\n– Player UUID and name
\n– Tier selected
\n– Enchantment details (ID, name, level)
\n– Costs paid (XP + coins)
\n– Location (world + coordinates)
\n– Timestamp<\/p>\n
**Three Database Tables:**
\n1. **player_stats** – Aggregate statistics per player (total rolls, XP\/coins spent, tier breakdown)
\n2. **roll_history** – Individual roll records for detailed history
\n3. **daily_stats** – Server-wide daily aggregations for analytics<\/p>\n
**Players Can View:**
\n– `\/bubblerune stats` – Personal statistics (total rolls, tier distribution, resources spent)
\n– `\/bubblerune history [limit]` – Recent roll history with timestamps
\n– `\/bubblerune leaderboard` – Top rollers on the server<\/p>\n
**Admins Get:**
\n– Persistent data across server restarts
\n– Player engagement metrics
\n– Economy health monitoring (XP\/coin sinks)
\n– Tier distribution analytics<\/p>\n
### \ud83c\udfa8 Interactive GUI System
\n**Beautiful Tier Selection Interface**<\/p>\n
When players interact with a rune table, they see a 27-slot inventory GUI:
\n– **7 tier buttons** (slots 10-16) arranged in a row
\n– **Color-coded materials** per tier (white, lime, blue, red, orange, cyan, magenta wool)
\n– **Info button** (slot 22) showing current XP and coin balance
\n– **Visual feedback:**
\n – \u2728 Glow effect on affordable tiers
\n – \u26ab Gray glass for unaffordable tiers
\n – \ud83d\udd34 Red glass when on cooldown
\n– **Detailed lore** showing:
\n – XP cost range
\n – Coin cost
\n – Current balance
\n – Number of possible enchants<\/p>\n
### \ud83d\udd28 Rune Combining System
\n**Upgrade Lower Tiers to Higher Ones**<\/p>\n
Players can combine **3 runes of the same tier** in an anvil to create **1 rune of the next tier up**:
\n“`
\n3x Common \u2192 1x Uncommon
\n3x Uncommon \u2192 1x Rare
\n3x Rare \u2192 1x Epic
\n… and so on
\n“`<\/p>\n
**Features:**
\n– Configurable rune requirements (default: 3)
\n– Works in vanilla anvils (no custom GUIs needed)
\n– Preserves enchantments if runes have already been revealed
\n– Success messages with tier information
\n– Can be disabled if you prefer pure rolling<\/p>\n
This creates an alternate progression path and adds value to low-tier runes.<\/p>\n
### \ud83d\udcc5 Weekly Quest System
\n**6 Challenging Survival Quests**<\/p>\n
Quests reset every Monday at midnight, encouraging consistent engagement:<\/p>\n
**Quest Types:**
\n1. **Roll Master** – Roll X runes of any tier
\n2. **Rare Collector** – Roll X rare+ tier runes
\n3. **XP Spender** – Spend X total XP on runes
\n4. **Legendary Hunter** – Roll X legendary+ tier runes
\n5. **Rune Hoarder** – Accumulate X unrevealed runes in inventory
\n6. **High Roller** – Roll 1 very special tier rune<\/p>\n
**Rewards:**
\n– Configurable tier runes (default: rare\/epic\/legendary)
\n– Automatic reward delivery on completion
\n– PlaceholderAPI integration for external tracking
\n– View with `\/bubblerune quests`<\/p>\n
Perfect for weekly events, scoreboard competitions, or seasonal challenges.<\/p>\n
### \ud83c\udfaf Milestone Rewards
\n**Automatic Rewards for Total Rolls**<\/p>\n
Players receive rewards at **10 milestone thresholds**:
\n– 10, 25, 50, 100, 250, 500, 1,000, 2,500, 5,000, 10,000 rolls<\/p>\n
**Configurable Rewards:**
\n– Tier runes (guaranteed rewards)
\n– Custom commands (economy rewards, titles, permissions)
\n– Celebratory messages and effects
\n– Milestone tracking via PlaceholderAPI<\/p>\n
Encourages long-term engagement and creates memorable achievement moments.<\/p>\n
### \ud83c\udf86 Visual & Audio Effects
\n**Polished Player Experience**<\/p>\n
**Tier-Specific Particles:**
\n– Spiral animations for rare+ tiers
\n– Color-coded particles matching tier
\n– Configurable count and speed
\n– Async spawning (no lag)<\/p>\n
**Layered Sound Design:**
\n– Tier-specific pitch progression (1.0f \u2192 1.6f)
\n– Success sounds (ENTITY_PLAYER_LEVELUP)
\n– Bonus sounds for legendary+ (UI_TOAST_CHALLENGE_COMPLETE)
\n– Failure sounds (ENTITY_VILLAGER_NO)<\/p>\n
**Fireworks for Legendary+ Tiers:**
\n– Automatic firework spawn on rare rolls
\n– Tier-specific colors and patterns
\n– Configurable enable\/disable<\/p>\n
**Server Broadcasts:**
\n– Announce legendary+ rolls to all players
\n– Customizable MiniMessage\/legacy format messages
\n– Creates community excitement around rare drops<\/p>\n
### \ud83d\udd0c PlaceholderAPI Support
\n**25+ Placeholders for External Integration**<\/p>\n
**Basic Stats:** **Leaderboards:** **Milestones:** **Weekly Quests:** **Advanced:** Perfect for scoreboards, holograms, tab lists, and chat formatting.<\/p>\n ### \ud83c\udfa8 Text Formatting Support BubbleRune supports **all text formats** in config files:<\/p>\n **Legacy Color Codes:** `&a&lGreen Bold` All messages, rune names, and lore support these formats for complete visual customization.<\/p>\n ### \ud83d\udccd Multiple Rune Tables Set up unlimited rune tables across all worlds: Each table shares the same functionality – perfect for hub setups, multi-world servers, or zone-based progression.<\/p>\n ### \u23f1\ufe0f Cooldown System Configurable per-player cooldowns: Prevents abuse while maintaining balanced progression.<\/p>\n —<\/p>\n ## \ud83d\udee0\ufe0f Technical Details<\/p>\n ### Performance Optimizations ### Error Handling ### Data Persistence ### Customization —<\/p>\n ## \ud83d\udccb Commands & Permissions<\/p>\n ### Player Commands ### Admin Commands —<\/p>\n ## \ud83d\udd17 Dependencies<\/p>\n ### Required ### Soft Dependencies (Optional) **All optional dependencies gracefully degrade** – the plugin works standalone but gains features when integrated.<\/p>\n —<\/p>\n ## \ud83d\ude80 Setup & Installation<\/p>\n 1. **Download** BubbleRune.jar from releases **First-Time Configuration Checklist:** —<\/p>\n ## \ud83d\udcd6 Use Cases<\/p>\n ### Survival Servers ### RPG Servers ### Economy Servers ### Minigame Servers —<\/p>\n ## \ud83d\udd27 Configuration Examples<\/p>\n ### Balanced Survival Economy ### XP-Only Mode ### High-Stakes Gambling ### Casual Server (Low Costs) —<\/p>\n ## \ud83d\udca1 Why Choose BubbleRune?<\/p>\n \u2705 **Feature-complete** – Everything you need out of the box —<\/p>\n ## \ud83d\udcca Statistics Example<\/p>\n After 1 week on a 50-player server: All tracked automatically in SQLite for admin analysis.<\/p>\n —<\/p>\n ## \ud83c\udfaf Target Audience<\/p>\n **Server Owners** seeking: **Players** who enjoy: —<\/p>\n ## \ud83d\udcde Support<\/p>\n – **Issues:** Report bugs via GitHub Issues —<\/p>\n ## \ud83d\udcdd License & Credits<\/p>\n **BubbleRune** – Created for BubbleCraft —<\/p>\n **Version:** 1.0.0 A Minecraft 1.21+ Purpur plugin for the BubbleCraft server that adds a rune system with EcoEnchants<\/p>\n","protected":false},"featured_media":35327,"template":"","meta":{"_minecraft_slug":"bubblerunes","_minecraft_project_id":"flxphw97","_minecraft_author":"ethan08921","_minecraft_license":"Apache-2.0","_minecraft_downloads":120,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bubblerunes.zip","_minecraft_size_bytes":571407,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T19:18:56.992176Z","_minecraft_date_created":"2025-12-17T23:48:06.973555Z","_minecraft_date_modified":"2026-01-05T02:24:45.713005Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bubblerunes","_minecraft_icon_attachment_id":35327,"_minecraft_imported_at":"2026-06-01T17:06:33+00:00","_minecraft_import_hash":"2e44cae607d512f24711fb6e5625699e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,122,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-35326","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-magic","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","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":"\n
\n– `%bubblerune_total_rolls%` – Server total
\n– `%bubblerune_player_rolls%` – Player total
\n– `%bubblerune_tier_
\n– `%bubblerune_cooldown%` – Remaining cooldown<\/p>\n
\n– `%bubblerune_leaderboard_1%` through `%bubblerune_leaderboard_10%`
\n– `%bubblerune_leaderboard_rolls_1%` through `%bubblerune_leaderboard_rolls_10%`
\n– `%bubblerune_rank%` – Player’s rank<\/p>\n
\n– `%bubblerune_next_milestone%`
\n– `%bubblerune_milestone_progress%`
\n– `%bubblerune_milestone_percent%`<\/p>\n
\n– `%bubblerune_quest_count%`
\n– `%bubblerune_quest_reset%`
\n– `%bubblerune_quest_progress_
\n– `%bubblerune_quest_complete_
\n– `%bubblerune_player_tier_
\n– `%bubblerune_rarest_rune%`
\n– `%bubblerune_total_xp_spent%`<\/p>\n
\n**Modern & Legacy Formats**<\/p>\n
\n**MiniMessage Tags:** `
\n**Gradients:** `
\n**Rainbow:** `
\n**Hex Colors:** `&#FF5733Custom Red` or `<#FF5733>Custom Red<\/color>`<\/p>\n
\n**Server-Wide Deployment**<\/p>\n
\n“`yaml
\nruneTables:
\n spawn:
\n world: world
\n x: 0
\n y: 64
\n z: 0
\n nether:
\n world: world_nether
\n x: 100
\n y: 65
\n z: -200
\n end:
\n world: world_the_end
\n x: 0
\n y: 50
\n z: 0
\n“`<\/p>\n
\n**Prevent Table Spam**<\/p>\n
\n– Default: 60 seconds
\n– Applies across all tables
\n– Shows remaining time in GUI and messages
\n– Automatic cleanup of expired cooldowns
\n– Can be disabled for unrestricted rolling<\/p>\n
\n– **Async database operations** – No main thread blocking
\n– **Async particle spawning** – Reduces lag on large effects
\n– **Concurrent data structures** – Thread-safe statistics
\n– **Indexed database queries** – Fast leaderboard lookups
\n– **Connection pooling** – Efficient SQLite usage
\n– **Configurable particle limits** – Prevent overload<\/p>\n
\n– **Atomic transactions** – Full refunds on any error
\n– **Graceful plugin degradation** – Works without optional dependencies
\n– **Comprehensive logging** – Debug information for admins
\n– **Inventory full detection** – No item loss
\n– **Reflection-based CoinsEngine** – No hard dependency crashes<\/p>\n
\n– **SQLite database** in `plugins\/BubbleRune\/data.db`
\n– **Automatic schema creation** on first run
\n– **Backwards-compatible configs** – Legacy settings still work
\n– **Daily stats tracking** – Historical data retention
\n– **Efficient indices** – Fast queries even with millions of rolls<\/p>\n
\n– **Two config files:** `config.yml` (mechanics) and `runes.yml` (appearance)
\n– **Per-tier enchant pools** – Control which enchants appear in each tier
\n– **Per-tier costs** – Separate XP and coin costs
\n– **Custom model data support** – Resource pack integration
\n– **Flexible messages** – All text customizable
\n– **Rune preview toggle** – Show tier before revealing<\/p>\n
\n| Command | Permission | Description |
\n|———|———–|————-|
\n| `\/bubblerune gui` | `bubblerune.gui` | Open tier selection GUI |
\n| `\/bubblerune stats` | – | View personal statistics |
\n| `\/bubblerune history [limit]` | – | View roll history (max 50) |
\n| `\/bubblerune quests` | – | View weekly quest progress |<\/p>\n
\n| Command | Permission | Description |
\n|———|———–|————-|
\n| `\/bubblerune reload` | `bubblerune.admin` | Reload configurations |
\n| `\/bubblerune settable [name]` | `bubblerune.admin` | Set rune table location |
\n| `\/bubblerune giverune
\n| `\/bubblerune testroll` | `bubblerune.admin` | Test tier weighting |
\n| `\/bubblerune leaderboard [limit]` | `bubblerune.leaderboard` | View top rollers |<\/p>\n
\n– **Minecraft 1.21+** (Purpur recommended, Paper\/Spigot compatible)
\n– **Java 21+**<\/p>\n
\n– **EcoEnchants** – Custom enchantments (highly recommended)
\n– **PlaceholderAPI** – Placeholder support for other plugins
\n– **CoinsEngine** – BubbleCoin economy integration<\/p>\n
\n2. **Place** in `plugins\/` folder
\n3. **Install optional plugins** (EcoEnchants, PlaceholderAPI, CoinsEngine)
\n4. **Start server** – configs auto-generate
\n5. **Configure enchant pools** in `config.yml` under `tiers.
\n6. **Customize rune appearance** in `runes.yml`
\n7. **Set table locations** with `\/bubblerune settable spawn` (while standing at enchantment table)
\n8. **Adjust economy costs** in `economy.bubbleCoinCosts` section
\n9. **Reload** with `\/bubblerune reload`<\/p>\n
\n– \u2705 Set enchantment IDs to match your EcoEnchants setup
\n– \u2705 Configure XP costs per tier
\n– \u2705 Configure BubbleCoin costs per tier
\n– \u2705 Customize rune names\/lore in runes.yml
\n– \u2705 Set cooldown duration
\n– \u2705 Place and register rune tables
\n– \u2705 Test with `\/bubblerune testroll`<\/p>\n
\n– XP sink preventing over-leveling
\n– Coin sink supporting economy health
\n– Progression goals for endgame players
\n– Community competition via leaderboards<\/p>\n
\n– Class-specific enchantment pools per tier
\n– Quest integration for narrative progression
\n– Milestone rewards as level-up bonuses
\n– Lore-friendly rune item customization<\/p>\n
\n– Trade commodity (unrevealed runes)
\n– Auction house integration
\n– Player shops selling specific tiers
\n– Coin + XP dual economy balance<\/p>\n
\n– Weekly quest competitions
\n– Seasonal leaderboard resets
\n– Tournament rewards (admin giverune command)
\n– VIP\/rank perks (reduced cooldowns via permissions)<\/p>\n
\n“`yaml
\neconomy:
\n bubbleCoinCosts:
\n common: 5
\n uncommon: 15
\n rare: 50
\n epic: 150
\n legendary: 500
\n“`<\/p>\n
\n“`yaml
\neconomy:
\n bubbleCoinEnabled: false
\n“`<\/p>\n
\n“`yaml
\ntiers:
\n legendary:
\n xpCost:
\n min: 100000
\n max: 100000 # Fixed cost
\neconomy:
\n bubbleCoinCosts:
\n legendary: 1000
\n“`<\/p>\n
\n“`yaml
\ntiers:
\n common:
\n xpCost:
\n min: 100
\n max: 200
\neconomy:
\n bubbleCoinCosts:
\n common: 1
\n uncommon: 1
\n rare: 2
\n“`<\/p>\n
\n\u2705 **Performance-focused** – Async operations, optimized queries
\n\u2705 **Extensively customizable** – 200+ config options
\n\u2705 **Active development** – Regular updates and bug fixes
\n\u2705 **Database-backed** – Never lose player progress
\n\u2705 **Economy integration** – Works with existing plugins
\n\u2705 **Modern codebase** – Java 21, latest APIs
\n\u2705 **No dependencies required** – Soft-depend architecture
\n\u2705 **Visual polish** – Particles, sounds, fireworks
\n\u2705 **Community features** – Leaderboards, quests, milestones<\/p>\n
\n– 15,000+ total rolls recorded
\n– 42 active players in database
\n– 750,000 XP consumed (economy sink)
\n– 12,500 BubbleCoins consumed (coin sink)
\n– Top player: 847 rolls
\n– Rarest tier rolled: Very Special (12 times)<\/p>\n
\n– Unique enchantment progression
\n– Player retention mechanics
\n– Economy sinks for balance
\n– Community engagement tools
\n– Data-driven insights<\/p>\n
\n– Loot box mechanics (but balanced)
\n– Long-term progression
\n– Leaderboard competition
\n– Weekly challenges
\n– Resource management<\/p>\n
\n– **Updates:** Watch the repository for releases
\n– **Discord**<\/p>\n
\n– Licensed under standard plugin terms
\n– EcoEnchants integration (Auxilor)
\n– CoinsEngine integration (NightExpress)
\n– PlaceholderAPI support (clip)<\/p>\n
\n**Minecraft:** 1.21+
\n**Last Updated:** December 2025<\/p>\n","protected":false},"excerpt":{"rendered":"