BubbleRune - 高级符文系统,含经济系统与统计数据
一款功能丰富的附魔符文插件,支持层级选择、双货币经济系统、SQLite 统计数据追踪以及高度自定义。
? 概览
BubbleRune 将传统的附魔体验转变为引人入胜的进度系统,玩家使用附魔台作为“符文台”来抽取分层级的符文物品。每个符文都可以被揭示以获得强大的 EcoEnchants 自定义附魔,从而形成一个奖励性的游戏循环,鼓励探索、刷怪和战略性资源管理。
与简单的附魔插件不同,BubbleRune 具备以下特点:
- 玩家选择权 - 通过交互式 GUI 选择要抽取的层级
- 双货币经济系统 - 同时消耗经验值(XP)和 BubbleCoins(集成 CoinsEngine)
- 持久化统计数据 - SQLite 数据库记录每一次抽取、玩家统计数据和排行榜
- 进度系统 - 每周任务、里程碑以及符文合成机制
- 视觉特效 - 特定层级的粒子效果、音效、烟花和庆祝特效
非常适合希望为其附魔系统增加深度的生存服务器、RPG 服务器以及注重经济的社区。
✨ 主要特性
? 基于层级的符文系统
7 种独特层级: 普通 → 不常见 → 稀有 → 史诗 → 传说 → 特殊 → 非常特殊
玩家与指定的附魔台交互以打开一个显示所有 7 个层级的 GUI。每个层级:
- 具有可配置的经验值消耗(最小/最大范围以增加变化性)
- 具有可配置的 BubbleCoin 消耗(每个层级独立设置)
- 显示 affordability 指示器(买得起时显示彩色羊毛,买不起时显示灰色玻璃)
- 显示成本范围、附魔数量和玩家余额
- 当玩家买得起时会发光
进度示例:
普通: 1,000-2,000 XP + 1 硬币 → 基础附魔
不常见: 3,000-5,000 XP + 2 硬币 → 更好的附魔
稀有: 7,000-10,000 XP + 5 硬币 → 强力附魔
史诗: 15,000-25,000 XP + 10 硬币 → 非常强力
传说: 50,000-75,000 XP + 25 硬币 → 稀有附魔
特殊: 100,000-150,000 XP + 50 硬币 → 超稀有
非常特殊: 250,000-500,000 XP + 100 硬币 → 专属附魔
? 双货币经济系统
无缝集成 CoinsEngine(可选但推荐)
每个层级都可以拥有自己的 BubbleCoin 消耗,从而产生有意义的经济决策:
- 低层级(1-5 硬币)- 新手玩家即可获取
- 高层级(25-100 硬币)- 需要专门的 farming/交易
- 按层级可配置 - 可将任意层级设置为 0,仅通过经验值抽取
- 自动退款 - 如果符文创建失败,经验值和硬币都会退还
- 优雅降级 - 即使没有安装 CoinsEngine,插件也能正常工作(禁用硬币消耗)
双货币系统防止了仅靠经验值 farming 的行为,并融入了您现有的经济体系,使符文成为有价值的服务器商品。
? SQLite 数据库与统计数据
全面的数据追踪
每次符文抽取都会被永久存储,包含:
- 玩家 UUID 和名称
- 所选层级
- 附魔详情(ID、名称、等级)
- 支付的成本(XP + 硬币)
- 位置(世界 + 坐标)
- 时间戳
三个数据库表:
- player_stats - 每位玩家的聚合统计数据(总抽取次数、XP/硬币花费、层级分布)
- roll_history - 单个抽取记录,用于详细历史查询
- daily_stats - 全服每日聚合数据,用于分析
玩家可查看:
/bubblerune stats - 个人统计数据(总抽取次数、层级分布、资源花费)
/bubblerune history [limit] - 最近的抽取历史记录,带时间戳
/bubblerune leaderboard - 服务器上的顶级抽取者排行榜
管理员获得:
- 跨服务器重启的持久化数据
- 玩家参与度指标
- 经济健康状况监控(XP/硬币消耗点)
- 层级分布分析
? 交互式 GUI 系统
美观的层级选择界面
当玩家与符文台交互时,他们会看到一个 27 格的库存 GUI:
- 7 个层级按钮(槽位 10-16)排列成一行
- 每层级对应的彩色材质(白色、 lime 色、蓝色、红色、橙色、青色、紫红色羊毛)
- 信息按钮(槽位 22)显示当前的 XP 和硬币余额
- 视觉反馈:
- ✨ 可负担的层级会有发光效果
- ⚫ 不可负担的层级显示为灰色玻璃
- ? 冷却期间显示为红色玻璃
- 详细的 Lore 文本显示:
- XP 成本范围
- 硬币成本
- 当前余额
- 可能的附魔数量
? 符文合成系统
将低层级符文升级为更高层级
玩家可以在铁砧中将3 个相同层级的符文合成为1 个上一层级的符文:
3x 普通 → 1x 不常见
3x 不常见 → 1x 稀有
3x 稀有 → 1x 史诗
...以此类推
特性:
- 可配置符文需求数量(默认:3 个)
- 在原版铁砧中工作(无需自定义 GUI)
- 如果符文已经被揭示,则保留附魔
- 带有层级信息的成功消息
- 如果您更喜欢纯抽取模式,可以禁用此功能
这创造了一条替代的进度路径,并为低层级符文增添了价值。
? 每周任务系统
6 个具有挑战性的生存任务
任务每周一午夜重置,鼓励持续参与:
任务类型:
- 抽取大师 - 抽取 X 个任意层级的符文
- 稀有收藏家 - 抽取 X 个稀有及以上层级的符文
- XP 消耗者 - 在符文上花费总计 X 经验值
- 传说猎人 - 抽取 X 个传说及以上层级的符文
- 符文囤积者 - 在背包中累积 X 个未揭示的符文
- 高注码玩家 - 抽取 1 个非常特殊层级的符文
奖励:
- 可配置的层级符文(默认:稀有/史诗/传说)
- 完成后自动发放奖励
- PlaceholderAPI 集成用于外部追踪
- 使用
/bubblerune quests 查看
非常适合每周活动、记分板竞赛或季节性挑战。
? 里程碑奖励
总抽取次数的自动奖励
玩家在达到 10 个里程碑阈值时会收到奖励:
- 10, 25, 50, 100, 250, 500, 1,000, 2,500, 5,000, 10,000 次抽取
可配置奖励:
- 等级符文(保底奖励)
- 自定义命令(经济奖励、头衔、权限)
- 庆祝消息与特效
- 通过 PlaceholderAPI 追踪里程碑
鼓励长期参与,并创造令人难忘的成就时刻。
? 视觉与音频特效
精致的玩家体验
特定等级的粒子效果:
- 稀有及以上等级的螺旋动画
- 与等级匹配的颜色编码粒子
- 可配置的粒子和速度
- 异步生成(无卡顿)
分层音效设计:
- 等级特定的音调递进(1.0f → 1.6f)
- 成功音效 (ENTITY_PLAYER_LEVELUP)
- 传说及以上等级的额外音效 (UI_TOAST_CHALLENGE_COMPLETE)
- 失败音效 (ENTITY_VILLAGER_NO)
传说及以上等级的烟花:
- 稀有掷骰时自动生成烟花
- 特定等级的颜色和图案
- 可配置启用/禁用
服务器广播:
- 向所有玩家公告传说及以上等级的掉落
- 可定制的 MiniMessage/传统格式消息
- 围绕稀有掉落营造社区兴奋感
? PlaceholderAPI 支持
25+ 占位符用于外部集成
基础统计:
%bubblerune_total_rolls% - 服务器总数
%bubblerune_player_rolls% - 玩家总数
%bubblerune_tier_<tier>% - 特定等级计数
%bubblerune_cooldown% - 剩余冷却时间
排行榜:
%bubblerune_leaderboard_1% 至 %bubblerune_leaderboard_10%
%bubblerune_leaderboard_rolls_1% 至 %bubblerune_leaderboard_rolls_10%
%bubblerune_rank% - 玩家排名
里程碑:
%bubblerune_next_milestone%
%bubblerune_milestone_progress%
%bubblerune_milestone_percent%
每周任务:
%bubblerune_quest_count%
%bubblerune_quest_reset%
%bubblerune_quest_progress_<id>%
%bubblerune_quest_complete_<id>%
高级功能:
%bubblerune_player_tier_<tier>%
%bubblerune_rarest_rune%
%bubblerune_total_xp_spent%
完美适用于计分板、全息图、Tab 列表和聊天格式化。
? 文本格式化支持
现代与传统格式
BubbleRune 支持配置文件中的 所有文本格式:
传统颜色代码: &a&lGreen Bold
MiniMessage 标签: <green><bold>Green Bold</bold></green>
渐变: <gradient:red:blue>Smooth transition</gradient>
彩虹: <rainbow>Rainbow text!</rainbow>
十六进制颜色: &#FF5733Custom Red 或 <#FF5733>Custom Red</color>
所有消息、符文名称和描述均支持这些格式,以实现完全自定义视觉效果。
? 多个符文台
全服部署
在所有世界中设置无限数量的符文台:
runeTables:
spawn:
world: world
x: 0
y: 64
z: 0
nether:
world: world_nether
x: 100
y: 65
z: -200
end:
world: world_the_end
x: 0
y: 50
z: 0
每个符文台共享相同的功能——非常适合大厅设置、多世界服务器或基于区域的进度系统。
⏱️ 冷却系统
防止频繁使用符文台
可配置的玩家个人冷却时间:
- 默认:60 秒
- 适用于所有符文台
- 在 GUI 和消息中显示剩余时间
- 自动清理过期的冷却时间
- 可禁用以允许无限制投掷
防止滥用,同时保持平衡的进度。
?️ 技术细节
性能优化
- 异步数据库操作 - 不阻塞主线程
- 异步粒子生成 - 减少大型效果的卡顿
- 并发数据结构 - 线程安全的统计数据
- 索引数据库查询 - 快速查找排行榜
- 连接池 - 高效使用 SQLite
- 可配置的粒子限制 - 防止过载
错误处理
- 原子事务 - 任何错误时全额退款
- 插件优雅降级 - 无需可选依赖即可运行
- 全面的日志记录 - 为管理员提供调试信息
- 满背包检测 - 不会丢失物品
- 基于反射的 CoinsEngine - 避免硬依赖崩溃
数据持久化
plugins/BubbleRune/data.db 中的 SQLite 数据库
- 首次运行时 自动创建架构
- 向后兼容的配置 - 旧版设置仍然有效
- 每日统计跟踪 - 保留历史数据
- 高效索引 - 即使有数百万次投掷也能快速查询
自定义
- 两个配置文件:
config.yml(机制)和 runes.yml(外观)
- 特定等级的附魔池 - 控制每个等级出现的附魔
- 特定等级的成本 - 分离 XP 和金币成本
- 自定义模型数据支持 - 资源包集成
- 灵活的消息 - 所有文本均可自定义
- 符文预览切换 - 揭示前显示等级
? 命令与权限
玩家命令
| 命令 |
权限 |
描述 |
/bubblerune gui |
bubblerune.gui |
打开等级选择 GUI |
/bubblerune stats |
- |
查看个人统计数据 |
/bubblerune history [limit] |
- |
查看投掷历史(最多 50 条) |
/bubblerune quests |
- |
查看每周任务进度 |
管理员命令
| 命令 |
权限 |
描述 |
/bubblerune reload |
bubblerune.admin |
重新加载配置 |
/bubblerune settable [name] |
bubblerune.admin |
设置符文台位置 |
/bubblerune giverune <player> <tier> |
bubblerune.admin |
给玩家发放符文 |
/bubblerune testroll |
bubblerune.admin |
测试等级权重 |
/bubblerune leaderboard [limit] |
bubblerune.leaderboard |
查看顶级投掷者 |
? 依赖项
必需
- Minecraft 1.21+(推荐 Purpur,兼容 Paper/Spigot)
- Java 21+
软依赖(可选)
- EcoEnchants - 自定义附魔(强烈推荐)
- PlaceholderAPI - 其他插件的占位符支持
- CoinsEngine - BubbleCoin 经济集成
所有可选依赖项均优雅降级 - 插件可独立运行,但在集成时会获得额外功能。
? 设置与安装
- 下载
BubbleRune.jar 发布版
- 放置到
plugins/ 文件夹中
- 安装可选插件(EcoEnchants、PlaceholderAPI、CoinsEngine)
- 启动服务器 - 配置文件自动生成
- 在
config.yml 的 tiers.<tier>.enchants 下配置附魔池
- 在
runes.yml 中自定义符文外观
- 使用
/bubblerune settable spawn 设置桌子位置(站在附魔台旁时执行)
- 在
economy.bubbleCoinCosts 部分调整经济消耗
- 使用
/bubblerune reload 重载配置
首次配置检查清单:
- ✅ 设置附魔 ID 以匹配你的 EcoEnchants 设置
- ✅ 配置每个等级的经验值消耗
- ✅ 配置每个等级的 BubbleCoin 消耗
- ✅ 在 runes.yml 中自定义符文名称/描述
- ✅ 设置冷却时间
- ✅ 放置并注册符文桌子
- ✅ 使用
/bubblerune testroll 进行测试
? 使用场景
生存服
- 防止玩家等级过高的经验值消耗途径
- 支持经济健康的金币消耗途径
- 为终局玩家提供进度目标
- 通过排行榜促进社区竞争
RPG 服
- 按等级划分的职业专属附魔池
- 叙事性进度的任务集成
- 作为升级奖励里程碑
- 符合 lore 设定的符文物品自定义
经济服
- 交易商品(未揭示的符文)
- 拍卖行集成
- 玩家商店出售特定等级
- 金币 + 经验值双经济平衡
小游戏服
- 每周任务竞赛
- 季节性排行榜重置
- 锦标赛奖励(管理员使用 giverune 命令发放)
- VIP/特权加成(通过权限减少冷却时间)
? 配置示例
平衡的生存经济
economy:
bubbleCoinCosts:
common: 5
uncommon: 15
rare: 50
epic: 150
legendary: 500
仅经验值模式
economy:
bubbleCoinEnabled: false
高风险赌博
tiers:
legendary:
xpCost:
min: 100000
max: 100000 # 固定费用
economy:
bubbleCoinCosts:
legendary: 1000
休闲服(低消耗)
tiers:
common:
xpCost:
min: 100
max: 200
economy:
bubbleCoinCosts:
common: 1
uncommon: 1
rare: 2
? 为什么选择 BubbleRune?
✅ 功能完整 - 开箱即用的所有必要功能
✅ 性能优先 - 异步操作,优化查询
✅ 高度可定制 - 200+ 配置选项
✅ 活跃开发 - 定期更新和错误修复
✅ 数据库支持 - 永不丢失玩家进度
✅ 经济集成 - 与现有插件兼容
✅ 现代代码库 - Java 21,最新 API
✅ 无需依赖 - 软依赖架构
✅ 视觉特效 - 粒子效果、音效、烟花
✅ 社区功能 - 排行榜、任务、里程碑
? 统计示例
在拥有 50 名玩家的服务器上运行一周后:
- 记录总抽奖次数超过 15,000 次
- 数据库中有 42 名活跃玩家
- 消耗了 750,000 经验值(经济消耗)
- 消耗了 12,500 BubbleCoins(金币消耗)
- 排名第一的玩家:847 次抽奖
- 抽到的最少见等级:Very Special(12 次)
所有数据均自动记录在 SQLite 中,供管理员分析。
? 目标受众
寻求以下功能的服务器所有者:
- 独特的附魔进度系统
- 玩家留存机制
- 用于平衡的经济消耗途径
- 社区互动工具
- 数据驱动的洞察
喜欢以下内容的玩家:
- 战利品箱机制(但经过平衡处理)
- 长期进度
- 排行榜竞争
- 每周挑战
- 资源管理
? 支持
- 问题反馈: 通过 GitHub Issues 报告 Bug
- 更新通知: 关注仓库以获取最新版本
? 许可证与鸣谢
BubbleRune - 为 BubbleCraft 创建
- 遵循标准插件条款授权
- 集成 EcoEnchants (Auxilor)
- 集成 CoinsEngine (NightExpress)
- 支持 PlaceholderAPI (clip)
版本: 1.0.0
Minecraft: 1.21+
最后更新: 2025年12月
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:
- player_stats - Aggregate statistics per player (total rolls, XP/coins spent, tier breakdown)
- roll_history - Individual roll records for detailed history
- daily_stats - Server-wide daily aggregations for analytics
Players Can View:
/bubblerune stats - Personal statistics (total rolls, tier distribution, resources spent)
/bubblerune history [limit] - 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 Quest System
6 Challenging Survival Quests
Quests reset every Monday at midnight, encouraging consistent engagement:
Quest Types:
- Roll Master - Roll X runes of any tier
- Rare Collector - Roll X rare+ tier runes
- XP Spender - Spend X total XP on runes
- Legendary Hunter - Roll X legendary+ tier runes
- Rune Hoarder - Accumulate X unrevealed runes in inventory
- High Roller - Roll 1 very special tier rune
Rewards:
- Configurable tier runes (default: rare/epic/legendary)
- Automatic reward delivery on completion
- PlaceholderAPI integration for external tracking
- View with
/bubblerune quests
Perfect for weekly events, scoreboard competitions, or seasonal challenges.
? Milestone Rewards
Automatic Rewards for Total Rolls
Players receive rewards at 10 milestone thresholds:
- 10, 25, 50, 100, 250, 500, 1,000, 2,500, 5,000, 10,000 rolls
Configurable Rewards:
- Tier runes (guaranteed rewards)
- Custom commands (economy rewards, titles, permissions)
- Celebratory messages and effects
- Milestone tracking via PlaceholderAPI
Encourages long-term engagement and creates memorable achievement moments.
? Visual & Audio Effects
Polished Player Experience
Tier-Specific Particles:
- Spiral animations for rare+ tiers
- Color-coded particles matching tier
- Configurable count and speed
- Async spawning (no lag)
Layered Sound Design:
- Tier-specific pitch progression (1.0f → 1.6f)
- Success sounds (ENTITY_PLAYER_LEVELUP)
- Bonus sounds for legendary+ (UI_TOAST_CHALLENGE_COMPLETE)
- Failure sounds (ENTITY_VILLAGER_NO)
Fireworks for Legendary+ Tiers:
- Automatic firework spawn on rare rolls
- Tier-specific colors and patterns
- Configurable enable/disable
Server Broadcasts:
- Announce legendary+ rolls to all players
- Customizable MiniMessage/legacy format messages
- Creates community excitement around rare drops
? PlaceholderAPI Support
25+ Placeholders for External Integration
Basic Stats:
%bubblerune_total_rolls% - Server total
%bubblerune_player_rolls% - Player total
%bubblerune_tier_<tier>% - Tier-specific counts
%bubblerune_cooldown% - Remaining cooldown
Leaderboards:
%bubblerune_leaderboard_1% through %bubblerune_leaderboard_10%
%bubblerune_leaderboard_rolls_1% through %bubblerune_leaderboard_rolls_10%
%bubblerune_rank% - Player's rank
Milestones:
%bubblerune_next_milestone%
%bubblerune_milestone_progress%
%bubblerune_milestone_percent%
Weekly Quests:
%bubblerune_quest_count%
%bubblerune_quest_reset%
%bubblerune_quest_progress_<id>%
%bubblerune_quest_complete_<id>%
Advanced:
%bubblerune_player_tier_<tier>%
%bubblerune_rarest_rune%
%bubblerune_total_xp_spent%
Perfect for scoreboards, holograms, tab lists, and chat formatting.
? Text Formatting Support
Modern & Legacy Formats
BubbleRune supports all text formats in config files:
Legacy Color Codes: &a&lGreen Bold
MiniMessage Tags: <green><bold>Green Bold</bold></green>
Gradients: <gradient:red:blue>Smooth transition</gradient>
Rainbow: <rainbow>Rainbow text!</rainbow>
Hex Colors: &#FF5733Custom Red or <#FF5733>Custom Red</color>
All messages, rune names, and lore support these formats for complete visual customization.
? Multiple Rune Tables
Server-Wide Deployment
Set up unlimited rune tables across all worlds:
runeTables:
spawn:
world: world
x: 0
y: 64
z: 0
nether:
world: world_nether
x: 100
y: 65
z: -200
end:
world: world_the_end
x: 0
y: 50
z: 0
Each table shares the same functionality - perfect for hub setups, multi-world servers, or zone-based progression.
⏱️ Cooldown System
Prevent Table Spam
Configurable per-player cooldowns:
- Default: 60 seconds
- Applies across all tables
- Shows remaining time in GUI and messages
- Automatic cleanup of expired cooldowns
- Can be disabled for unrestricted rolling
Prevents abuse while maintaining balanced progression.
?️ Technical Details
Performance Optimizations
- Async database operations - No main thread blocking
- Async particle spawning - Reduces lag on large effects
- Concurrent data structures - Thread-safe statistics
- Indexed database queries - Fast leaderboard lookups
- Connection pooling - Efficient SQLite usage
- Configurable particle limits - Prevent overload
Error Handling
- Atomic transactions - Full refunds on any error
- Graceful plugin degradation - Works without optional dependencies
- Comprehensive logging - Debug information for admins
- Inventory full detection - No item loss
- Reflection-based CoinsEngine - No hard dependency crashes
Data Persistence
- SQLite database in
plugins/BubbleRune/data.db
- Automatic schema creation on first run
- Backwards-compatible configs - Legacy settings still work
- Daily stats tracking - Historical data retention
- Efficient indices - Fast queries even with millions of rolls
Customization
- Two config files:
config.yml (mechanics) and runes.yml (appearance)
- Per-tier enchant pools - Control which enchants appear in each tier
- Per-tier costs - Separate XP and coin costs
- Custom model data support - Resource pack integration
- Flexible messages - All text customizable
- Rune preview toggle - Show tier before revealing
? Commands & Permissions
Player Commands
| Command |
Permission |
Description |
/bubblerune gui |
bubblerune.gui |
Open tier selection GUI |
/bubblerune stats |
- |
View personal statistics |
/bubblerune history [limit] |
- |
View roll history (max 50) |
/bubblerune quests |
- |
View weekly quest progress |
Admin Commands
| Command |
Permission |
Description |
/bubblerune reload |
bubblerune.admin |
Reload configurations |
/bubblerune settable [name] |
bubblerune.admin |
Set rune table location |
/bubblerune giverune <player> <tier> |
bubblerune.admin |
Give rune to player |
/bubblerune testroll |
bubblerune.admin |
Test tier weighting |
/bubblerune leaderboard [limit] |
bubblerune.leaderboard |
View top rollers |
? Dependencies
Required
- Minecraft 1.21+ (Purpur recommended, Paper/Spigot compatible)
- Java 21+
Soft Dependencies (Optional)
- EcoEnchants - Custom enchantments (highly recommended)
- PlaceholderAPI - Placeholder support for other plugins
- CoinsEngine - BubbleCoin economy integration
All optional dependencies gracefully degrade - the plugin works standalone but gains features when integrated.
? Setup & Installation
- Download BubbleRune.jar from releases
- Place in
plugins/ folder
- Install optional plugins (EcoEnchants, PlaceholderAPI, CoinsEngine)
- Start server - configs auto-generate
- Configure enchant pools in
config.yml under tiers.<tier>.enchants
- Customize rune appearance in
runes.yml
- Set table locations with
/bubblerune settable spawn (while standing at enchantment table)
- Adjust economy costs in
economy.bubbleCoinCosts section
- Reload with
/bubblerune reload
First-Time Configuration Checklist:
- ✅ Set enchantment IDs to match your EcoEnchants setup
- ✅ Configure XP costs per tier
- ✅ Configure BubbleCoin costs per tier
- ✅ Customize rune names/lore in runes.yml
- ✅ Set cooldown duration
- ✅ Place and register rune tables
- ✅ Test with
/bubblerune testroll
? Use Cases
Survival Servers
- XP sink preventing over-leveling
- Coin sink supporting economy health
- Progression goals for endgame players
- Community competition via leaderboards
RPG Servers
- Class-specific enchantment pools per tier
- Quest integration for narrative progression
- Milestone rewards as level-up bonuses
- Lore-friendly rune item customization
Economy Servers
- Trade commodity (unrevealed runes)
- Auction house integration
- Player shops selling specific tiers
- Coin + XP dual economy balance
Minigame Servers
- Weekly quest competitions
- Seasonal leaderboard resets
- Tournament rewards (admin giverune command)
- VIP/rank perks (reduced cooldowns via permissions)
? Configuration Examples
Balanced Survival Economy
economy:
bubbleCoinCosts:
common: 5
uncommon: 15
rare: 50
epic: 150
legendary: 500
XP-Only Mode
economy:
bubbleCoinEnabled: false
High-Stakes Gambling
tiers:
legendary:
xpCost:
min: 100000
max: 100000 # Fixed cost
economy:
bubbleCoinCosts:
legendary: 1000
Casual Server (Low Costs)
tiers:
common:
xpCost:
min: 100
max: 200
economy:
bubbleCoinCosts:
common: 1
uncommon: 1
rare: 2
? Why Choose BubbleRune?
✅ Feature-complete - Everything you need out of the box
✅ Performance-focused - Async operations, optimized queries
✅ Extensively customizable - 200+ config options
✅ Active development - Regular updates and bug fixes
✅ Database-backed - Never lose player progress
✅ Economy integration - Works with existing plugins
✅ Modern codebase - Java 21, latest APIs
✅ No dependencies required - Soft-depend architecture
✅ Visual polish - Particles, sounds, fireworks
✅ Community features - Leaderboards, quests, milestones
? Statistics Example
After 1 week on a 50-player server:
- 15,000+ total rolls recorded
- 42 active players in database
- 750,000 XP consumed (economy sink)
- 12,500 BubbleCoins consumed (coin sink)
- Top player: 847 rolls
- Rarest tier rolled: Very Special (12 times)
All tracked automatically in SQLite for admin analysis.
? Target Audience
Server Owners seeking:
- Unique enchantment progression
- Player retention mechanics
- Economy sinks for balance
- Community engagement tools
- Data-driven insights
Players who enjoy:
- Loot box mechanics (but balanced)
- Long-term progression
- Leaderboard competition
- Weekly challenges
- Resource management
? Support
- Issues: Report bugs via GitHub Issues
- Updates: Watch the repository for releases
? License & Credits
BubbleRune - Created for BubbleCraft
- Licensed under standard plugin terms
- EcoEnchants integration (Auxilor)
- CoinsEngine integration (NightExpress)
- PlaceholderAPI support (clip)
Version: 1.0.0
Minecraft: 1.21+
Last Updated: December 2025
评论 0
登录后参与评分
还没有评论,来抢沙发吧