Booster - 多功能游戏增强插件

你的服务器是生存服吗？你想让玩家能用游戏内货币购买飞行、快速挖掘等增益效果吗？那么这款插件正是为你和你的服务器量身打造的。

💡核心特性

本插件为玩家提供了多种增益效果（Booster），可通过游戏内货币购买和激活。激活后，增益效果将对全服玩家生效。插件使用 MySQL 数据库存储玩家的增益数据，并支持跨服同步，非常适合 BungeeCord 网络环境。

主要功能

• MySQL 支持：存储玩家增益数据，支持 BungeeCord 跨服。
• 全服共享：玩家激活的增益效果对所有在线玩家有效。
• 赠送系统：玩家之间可以互相赠送增益，即使对方不在线。
• 高度可配置：可自定义增益价格、持续时间、世界黑名单等。
• 权限系统：简单直观的权限管理。
• 图形界面：提供 GUI 菜单，操作方便。
• 多级增益：每种增益效果都有不同的强度等级。
• 管理员工具：提供完整的后台管理命令。

增益类型

• Break-Booster（挖掘加速）
• Drop-Booster（掉落物倍增）
• Mob-Booster（生物掉落倍增）
• Fly-Booster（飞行）
• XP-Booster（经验值倍增）
• Bonusbooster（每日/周期性的免费增益）

扩展支持 (AddOns)

• Dropheads
• Gutschein
• MultiServer
• JobsBooster
• Damage-Booster
• GodMode
• LuckPerms-Integration

🎮安装与要求

必需条件

• 服务器类型：Spigot / Paper 及其衍生服务端（请勿安装在 BungeeCord 代理端上）。
• 经济插件：Vault 及一个经济系统插件（推荐 EssentialsX 或付费的 CMI）。
• 权限插件：推荐使用 LuckPerms。

可选组件

• PlaceholderAPI：用于在聊天或其他插件中显示增益信息。
• MySQL Player Data Bridge：用于跨服玩家数据同步。

配置文件

• 默认配置文件位于插件目录内。
• 英文配置示例：https://git.t2code.net/Jakob/Booster_Issues/src/branch/main/Configs

测试服务器：t2code.net

🔧命令列表

玩家命令

• /booster status 或 booster.status - 查看当前激活的增益状态。
• /booster 或 booster.gui - 打开增益主菜单 (GUI)。
• /booster shop 或 /booster buy 或 booster.shop - 打开增益商店。
• /booster bonus 或 /bb 或 /bonusbooster 或 booster.bonusbooster - 领取每日/周期性奖励增益。
• /booster update 或 /booster refresh - 重新应用增益效果到自己身上。
• /booster send <玩家> <数量> <类型> 或 booster.send - 赠送增益给其他玩家。
• /booster break 或 booster.break - 激活一个挖掘增益。
• /booster drop 或 booster.drop - 激活一个掉落物增益。
• /booster fly 或 booster.fly - 激活一个飞行增益。
• /booster mob 或 booster.mob - 激活一个生物增益。
• /booster xp 或 booster.xp - 激活一个经验增益。

管理员命令

• /booster add <玩家> <数量> <类型> 或 booster.add - 给指定玩家添加增益。
• /booster giveall <数量> <类型> 或 booster.giveall - 给所有玩家添加增益。
• /booster remove <玩家> <数量> <类型> 或 booster.remove - 移除指定玩家的增益。
• /booster set <玩家> <数量> <类型> 或 booster.set - 设置指定玩家的增益数量。
• /booster see <玩家> <类型> 或 booster.see - 查看指定玩家的增益信息。
• /booster reload 或 /booster rl 或 booster.reload - 重载插件配置。
• /booster stop <类型> 或 booster.stop - 停止指定类型的所有增益。
• /booster stopall 或 booster.stopall - 停止所有增益。
• /booster bbreset <玩家> 或 booster.bbreset - 重置指定玩家的奖励增益计时器。
• /booster startall 或 booster.startall - 启动所有增益。

✨权限节点

玩家权限

• booster.player - 玩家所需的所有权限（总权限）。
• booster.updates - 当插件有更新时接收通知。
• booster.flybypass - 绕过飞行增益被强制关闭的限制（需在配置中启用）。

管理员权限

• booster.admin - 管理员所需的所有权限（总权限）。

（每个具体命令通常也对应同名的权限节点，例如 booster.add、booster.reload 等。）

⭐PlaceholderAPI 占位符

本插件提供了丰富的 PlaceholderAPI 占位符，可用于显示增益状态、数量、剩余时间等信息。

增益数量

• %booster_count_drop% - 掉落增益数量
• %booster_count_fly% - 飞行增益数量
• %booster_count_mob% - 生物增益数量
• %booster_count_xp% - 经验增益数量
• %booster_count_break% - 挖掘增益数量

奖励增益剩余时间

• %booster_bonus_remaining_min% - 剩余分钟
• %booster_bonus_remaining_hour% - 剩余小时
• %booster_bonus_remaining_days% - 剩余天数

增益等级 (Step)

• %booster_xp_step% - 经验增益等级
• %booster_fly_step% - 飞行增益等级
• %booster_break_step% - 挖掘增益等级
• %booster_drop_step% - 掉落增益等级
• %booster_mob_step% - 生物增益等级

增益激活状态

• %booster_xp_status% - 经验增益是否激活
• %booster_fly_status% - 飞行增益是否激活
• %booster_break_status% - 挖掘增益是否激活
• %booster_drop_status% - 掉落增益是否激活
• %booster_mob_status% - 生物增益是否激活

（以上状态文本可在配置中自定义）

增益剩余时间（全局/等级）

• %booster_xp_remainingtime_global_m% - 经验增益总剩余时间（分钟）
• %booster_xp_remainingtime_global_s% - 经验增益总剩余时间（秒）
• %booster_xp_remainingtime_step_m% - 经验增益当前等级剩余时间（分钟）
• %booster_xp_remainingtime_step_s% - 经验增益当前等级剩余时间（秒）

（其他增益类型如 fly, break, mob, drop 均有对应的 _remainingtime_global_m/s 和 _remainingtime_step_m/s 占位符）

队列与忽略状态

• %booster_xp_queue% - 经验增益队列中的数量

（其他增益类型如 fly, break, mob, drop 均有对应的 _queue% 占位符）

• %booster_ignore_drop% - 掉落增益是否被忽略

（其他增益类型如 fly, mob, xp, break 均有对应的 _ignore_% 占位符）

❓API 开发者接口

插件提供了完整的 API 供开发者调用。

Maven 依赖

<repository>
    <id>T2Code</id>
    <url>https://repo.t2code.net/repository/T2Code/</url>
</repository>

<dependency>
    <groupId>net.t2code</groupId>
    <artifactId>Booster</artifactId>
    <version>{version}</version>
</dependency>

事件监听

public class Booster implements Listener {
    @EventHandler
    public void onBoosterStart(BoosterStartEvent e) {
        // 当增益启动时触发
    }

    @EventHandler
    public void onBoosterStop(BoosterStopEvent e) {
        // 当增益停止时触发
    }
}

API 使用示例

private void booster(Player player) {
    // 获取 API 实例
    BoosterAPI api = new BoosterAPI();

    // 给玩家添加增益
    api.addBooster(player, 1, Main.XP);

    // 移除玩家的增益
    api.removeBooster(player, 1, Main.DROP);

    // 获取玩家特定增益的数量
    int count = api.getCount(player, Main.BREAK);

    // 重置玩家的奖励增益计时器
    api.resetBonusBooster(player);

    // 获取当前激活增益的等级
    int step = api.getStep(Main.MOB);

    // 启动增益（多种方式）
    api.startBooster(Main.FLY); // 全局启动
    api.startBooster(Main.FLY, player); // 为特定玩家启动
    api.startBooster(Main.FLY, 1); // 启动指定等级
    api.startBooster(Main.FLY, player, 1); // 为玩家启动指定等级

    // 停止特定类型的增益
    api.stopBooster(Main.XP);

    // 停止所有增益
    api.stopBooster();
}