BubblePerks

插件

· 作者 ethan08921

一个现代且功能丰富的 Minecraft 1.21.8+ 服务器专属奖励系统,原生支持 CoinsEngine。

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

最新 2.0.1 · 26.1.2 · Bukkit / Paper

一键开服(送7天)

BubblePerks

版本 2.0.0 - 适用于 Minecraft 1.21.8+ 服务器的现代化、功能丰富的特权系统,原生支持 CoinsEngine。

一个全面的特权系统,允许玩家通过优雅的图形用户界面(GUI)使用游戏内货币购买各种升级和实用命令。

✨ 特性

  • 精美 GUI:现代特权菜单,包含渐变文本、边框和分类区域
  • CoinsEngine 集成:原生支持 CoinsEngine v2.5.0+,具备自动货币检测功能
  • Vault 兼容性:无缝回退至 Vault 经济系统
  • 多种特权类型:命令、升级、实用工具和进阶层级
  • PlaceholderAPI 支持:自定义占位符以与其他插件集成
  • 权限集成:通过 LuckPerms 自动授予权限
  • 完全可配置:可自定义特权、成本、要求和奖励
  • 数据库支持:支持 SQLite 和 MySQL 以实现数据持久化
  • 多层级升级:针对家园、金库和工作职位的渐进式升级系统

? 特权类别

实用命令特权

  • 砂轮 (Grindstone):访问 /grindstone 命令(虚拟砂轮)
  • 工作台 (Workbench):访问 /craft 命令(虚拟合成台)
  • 铁砧 (Anvil):访问 /anvil 命令(虚拟铁砧)
  • 末影箱 (Ender Chest):访问 /echest 命令(虚拟末影箱)
  • 制图台 (Cartography Table):访问 /cartographytable 命令(虚拟制图台)
  • 切石机 (Stonecutter):访问 /stonecutter 命令(虚拟切石机)

渐进式升级特权

  • 家园 (Homes):增加最大家园数量(3 个层级:+3, +5, +7 个家园)
  • 金库 (Vaults):解锁额外金库(3 个层级:+1, +1, +2 个金库)
  • 工作 (Jobs):增加工作槽位(3 个层级:+1, +1, +1 个工作槽位)

? 命令

  • /perks - 打开特权 GUI
  • /perks help - 显示帮助信息
  • /perks reload - 重新加载插件配置(仅限管理员)

? 权限

  • bubbleperks.use - 基本访问特权系统(默认:true)
  • bubbleperks.admin - 管理访问权限(默认:op)
  • bubbleperks.bypass - 绕过所有特权要求(默认:false)

?️ 占位符

安装 PlaceholderAPI 后,可使用以下占位符:

  • %bubbleperks_has_<perkid>% - 检查玩家是否已购买某项特权
  • %bubbleperks_level_<perkid>% - 获取玩家的特权等级
  • %bubbleperks_total_perks% - 获取玩家拥有的特权总数

? 依赖项

必需

  • Vault - 经济集成(备用方案)
  • LuckPerms - 权限管理

可选

  • CoinsEngine - 主要经济系统(推荐,v2.5.0+)
  • PlaceholderAPI - 占位符支持
  • Essentials - 命令特权集成及经济备用方案
  • Jobs - 工作槽位升级
  • AxVaults - 金库升级

? 安装

  1. 下载最新版本 (BubblePerks-2.0.0.jar)
  2. 将 JAR 文件放入 plugins 文件夹
  3. 安装所需依赖项:
    • Vault(经济桥接)
    • LuckPerms(权限)
    • CoinsEngine(推荐用于货币)或 Essentials(经济备用方案)
  4. 重启服务器
  5. 在 plugins/BubblePerks/ 中配置插件文件
  6. 在 config.yml 下的 economy.coinsengine-currency 设置你的货币 ID
  7. 使用 /perks reload 重新加载

⚙️ 配置

config.yml

主插件配置,包括经济设置、GUI 选项和集成设置。

经济设置 (v2.0.0+):

economy:
  currency-symbol: '?'
  format-thousands: true
  coinsengine-currency: 'coins'  # 你的 CoinsEngine 货币 ID
  use-coinsengine: true           # 使用 CoinsEngine 而非 Vault

perks.yml

定义所有可用的特权,包括成本、权限、命令和奖励。

messages.yml

自定义所有插件消息及向玩家显示的文本。

API 用法

// 获取插件实例
BubblePerks plugin = (BubblePerks) Bukkit.getPluginManager().getPlugin("BubblePerks");

// 检查玩家是否拥有某项特权
boolean hasPerk = plugin.getPerkManager().hasPlayerPurchased(player, "grindstone");

// 获取玩家的特权等级
int level = plugin.getPerkManager().getPlayerPerkLevel(player, "homes_tier1");

// 以编程方式购买特权
boolean success = plugin.getPerkManager().purchasePerk(player, "workbench");

支持

如需支持、错误报告或功能请求,请在 GitHub 仓库中提交 Issue。

许可证

本项目采用 MIT 许可证授权 - 详见 LICENSE 文件。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源