BubbleRunes

插件

· 作者 ethan08921

适用于 BubbleCraft 服务器的 Minecraft 1.21+ Purpur 插件,添加了与 EcoEnchants 结合的符文系统

0 本站下载 0 关注 更新于 6 个月前

最新 1.0.6 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

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 + 硬币)
  • 位置(世界 + 坐标)
  • 时间戳

三个数据库表:

  1. player_stats - 每位玩家的聚合统计数据(总抽取次数、XP/硬币花费、层级分布)
  2. roll_history - 单个抽取记录,用于详细历史查询
  3. 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 个具有挑战性的生存任务

任务每周一午夜重置,鼓励持续参与:

任务类型:

  1. 抽取大师 - 抽取 X 个任意层级的符文
  2. 稀有收藏家 - 抽取 X 个稀有及以上层级的符文
  3. XP 消耗者 - 在符文上花费总计 X 经验值
  4. 传说猎人 - 抽取 X 个传说及以上层级的符文
  5. 符文囤积者 - 在背包中累积 X 个未揭示的符文
  6. 高注码玩家 - 抽取 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 经济集成

所有可选依赖项均优雅降级 - 插件可独立运行,但在集成时会获得额外功能。


? 设置与安装

  1. 下载 BubbleRune.jar 发布版
  2. 放置到 plugins/ 文件夹中
  3. 安装可选插件(EcoEnchants、PlaceholderAPI、CoinsEngine)
  4. 启动服务器 - 配置文件自动生成
  5. 在 config.yml 的 tiers.<tier>.enchants 下配置附魔池
  6. 在 runes.yml 中自定义符文外观
  7. 使用 /bubblerune settable spawn 设置桌子位置(站在附魔台旁时执行)
  8. 在 economy.bubbleCoinCosts 部分调整经济消耗
  9. 使用 /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月

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源