BubbleRunes

# BubbleRune - Advanced Rune System with Economy & Statistics

A feature-rich enchantment rune plugin with tier selection, dual-currency economy, SQLite statistics tracking, and extensive customization.

## 🎯 Overview

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.

Unlike simple enchantment plugins, BubbleRune features: - Player choice - Select which tier to roll from an interactive GUI - Dual-currency economy - Costs both XP and BubbleCoins (CoinsEngine integration) - Persistent statistics - SQLite database tracks every roll, player stats, and leaderboards - Progression systems - Weekly quests, milestones, and rune combining mechanics - Visual polish - Tier-specific particles, sounds, fireworks, and celebration effects

Perfect for survival servers, RPG servers, and economy-focused communities looking to add depth to their enchantment system.

## ✨ Key Features

### 🎲 Tier-Based Rune System 7 Distinct Tiers: Common → Uncommon → Rare → Epic → Legendary → Special → Very Special

Players interact with designated enchantment tables to open a GUI showing all 7 tiers. Each tier: - Has configurable XP costs (min/max ranges for variation) - Has configurable BubbleCoin costs (separate per tier) - Shows affordability indicators (colored wool when affordable, gray glass when not) - Displays cost ranges, enchant counts, and player balances - Glows when the player can afford it

Example Progression: ``` Common: 1,000-2,000 XP + 1 coin → Basic enchants Uncommon: 3,000-5,000 XP + 2 coins → Better enchants Rare: 7,000-10,000 XP + 5 coins → Powerful enchants Epic: 15,000-25,000 XP + 10 coins → Very powerful Legendary: 50,000-75,000 XP + 25 coins → Rare enchants Special: 100,000-150,000 XP + 50 coins → Ultra rare Very Special: 250,000-500,000 XP + 100 coins → Exclusive enchants ```

### 💰 Dual-Currency Economy System Seamless CoinsEngine Integration (optional but recommended)

Each tier can have its own BubbleCoin cost, creating meaningful economic decisions: - Low tiers (1-5 coins) - Accessible for new players - High tiers (25-100 coins) - Require dedicated farming/trading - Configurable per tier - Set any tier to 0 for XP-only rolling - Automatic refunds - If rune creation fails, both XP and coins are refunded - Graceful degradation - Plugin works without CoinsEngine (disables coin costs)

The dual-currency system prevents XP-only farming and integrates with your existing economy, making runes a valuable server commodity.

### 📊 SQLite Database & Statistics Comprehensive Data Tracking

Every rune roll is permanently stored with: - Player UUID and name - Tier selected - Enchantment details (ID, name, level) - Costs paid (XP + coins) - Location (world + coordinates) - Timestamp

Three Database Tables: 1. player_stats - Aggregate statistics per player (total rolls, XP/coins spent, tier breakdown) 2. roll_history - Individual roll records for detailed history 3. daily_stats - Server-wide daily aggregations for analytics

Players Can View: - `/bubblerune stats` - Personal statistics (total rolls, tier distribution, resources spent) - `/bubblerune history ` - Recent roll history with timestamps - `/bubblerune leaderboard` - Top rollers on the server

Admins Get: - Persistent data across server restarts - Player engagement metrics - Economy health monitoring (XP/coin sinks) - Tier distribution analytics

### 🎨 Interactive GUI System Beautiful Tier Selection Interface

When players interact with a rune table, they see a 27-slot inventory GUI: - 7 tier buttons (slots 10-16) arranged in a row - Color-coded materials per tier (white, lime, blue, red, orange, cyan, magenta wool) - Info button (slot 22) showing current XP and coin balance - Visual feedback: - ✨ Glow effect on affordable tiers - ⚫ Gray glass for unaffordable tiers - 🔴 Red glass when on cooldown - Detailed lore showing: - XP cost range - Coin cost - Current balance - Number of possible enchants

### 🔨 Rune Combining System Upgrade Lower Tiers to Higher Ones

Players can combine 3 runes of the same tier in an anvil to create 1 rune of the next tier up: ``` 3x Common → 1x Uncommon 3x Uncommon → 1x Rare 3x Rare → 1x Epic ... and so on ```

Features: - Configurable rune requirements (default: 3) - Works in vanilla anvils (no custom GUIs needed) - Preserves enchantments if runes have already been revealed - Success messages with tier information - Can be disabled if you prefer pure rolling

This creates an alternate progression path and adds value to low-tier runes.

### 📅 Weekly Qu