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 - 金库升级
? 安装
- 下载最新版本 (
BubblePerks-2.0.0.jar)
- 将 JAR 文件放入
plugins 文件夹
- 安装所需依赖项:
- Vault(经济桥接)
- LuckPerms(权限)
- CoinsEngine(推荐用于货币)或 Essentials(经济备用方案)
- 重启服务器
- 在
plugins/BubblePerks/ 中配置插件文件
- 在
config.yml 下的 economy.coinsengine-currency 设置你的货币 ID
- 使用
/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 文件。
BubblePerks
Version 2.0.0 - A modern, feature-rich perks system for Minecraft 1.21.8+ servers with native CoinsEngine support.
A comprehensive perks system that allows players to purchase various upgrades and utility commands using in-game currency through an elegant GUI.
✨ Features
- Beautiful GUI: Modern perks menu with gradient text, borders, and category sections
- CoinsEngine Integration: Native support for CoinsEngine v2.5.0+ with automatic currency detection
- Vault Compatibility: Seamless fallback to Vault economy systems
- Multiple Perk Types: Commands, upgrades, utilities, and progressive tiers
- PlaceholderAPI Support: Custom placeholders for integration with other plugins
- Permission Integration: Automatic permission granting via LuckPerms
- Fully Configurable: Customizable perks, costs, requirements, and rewards
- Database Support: SQLite and MySQL support for data persistence
- Multi-tier Upgrades: Progressive upgrade system for homes, vaults, and jobs
? Perk Categories
Utility Command Perks
- Grindstone: Access to
/grindstone command (virtual grindstone)
- Workbench: Access to
/craft command (virtual crafting table)
- Anvil: Access to
/anvil command (virtual anvil)
- Ender Chest: Access to
/echest command (virtual ender chest)
- Cartography Table: Access to
/cartographytable command (virtual cartography table)
- Stonecutter: Access to
/stonecutter command (virtual stonecutter)
Progressive Upgrade Perks
- Homes: Increase maximum home count (3 tiers: +3, +5, +7 homes)
- Vaults: Unlock additional vaults (3 tiers: +1, +1, +2 vaults)
- Jobs: Increase job slots (3 tiers: +1, +1, +1 job slots)
? Commands
/perks - Open the perks GUI
/perks help - Show help information
/perks reload - Reload plugin configuration (admin only)
? Permissions
bubbleperks.use - Basic access to perks system (default: true)
bubbleperks.admin - Administrative access (default: op)
bubbleperks.bypass - Bypass all perk requirements (default: false)
?️ Placeholders
When PlaceholderAPI is installed, the following placeholders are available:
%bubbleperks_has_<perkid>% - Check if player has purchased a perk
%bubbleperks_level_<perkid>% - Get player's perk level
%bubbleperks_total_perks% - Get total number of perks owned by player
? Dependencies
Required
- Vault - Economy integration (fallback)
- LuckPerms - Permission management
Optional
- CoinsEngine - Primary economy system (recommended, v2.5.0+)
- PlaceholderAPI - Placeholder support
- Essentials - Command perks integration & economy fallback
- Jobs - Job slot upgrades
- AxVaults - Vault upgrades
? Installation
- Download the latest release (
BubblePerks-2.0.0.jar)
- Place the JAR file in your
plugins folder
- Install required dependencies:
- Vault (economy bridge)
- LuckPerms (permissions)
- CoinsEngine (recommended for currency) OR Essentials (economy fallback)
- Restart your server
- Configure the plugin files in
plugins/BubblePerks/
- Set your currency ID in
config.yml under economy.coinsengine-currency
- Reload with
/perks reload
⚙️ Configuration
config.yml
Main plugin configuration including economy settings, GUI options, and integrations.
Economy Settings (v2.0.0+):
economy:
currency-symbol: '?'
format-thousands: true
coinsengine-currency: 'coins' # Your CoinsEngine currency ID
use-coinsengine: true # Use CoinsEngine instead of Vault
perks.yml
Define all available perks including costs, permissions, commands, and rewards.
messages.yml
Customize all plugin messages and text displayed to players.
API Usage
// Get the plugin instance
BubblePerks plugin = (BubblePerks) Bukkit.getPluginManager().getPlugin("BubblePerks");
// Check if player has a perk
boolean hasPerk = plugin.getPerkManager().hasPlayerPurchased(player, "grindstone");
// Get player's perk level
int level = plugin.getPerkManager().getPlayerPerkLevel(player, "homes_tier1");
// Purchase a perk programmatically
boolean success = plugin.getPerkManager().purchasePerk(player, "workbench");
Support
For support, bug reports, or feature requests, please open an issue on the GitHub repository.
License
This project is licensed under the MIT License - see the LICENSE file for details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧