EzBoost

**EzBoost** is a feature-rich potion boost plugin for Spigot, Paper, Bukkit, and **Folia** (Minecraft 1.21+). It provides an inventory GUI for boost selection, per-boost cooldowns, Vault economy integration, WorldGuard region overrides, boost token items, PlaceholderAPI support, persistent storage (YAML, SQLite, MySQL, MariaDB, PostgreSQL), and a leaderboard for top boost buyers. Inspired by (https://dev.bukkit.org/projects/redbull). !(https://i.ibb.co/cXTcS3LT/image.png) --- ## ✨ Key Features - **GUI-first activation**: Players can browse boosts with clear status, cooldown, and cost info. - **Admin GUI**: Create and manage boosts through an intuitive admin interface. - **Folia support**: Fully compatible with Folia servers – task scheduling routes through Folia's region schedulers automatically. - **Boost top leaderboard**: `/boosttop` displays the all-time top boost buyers, backed by persistent storage. - **Fully configurable boosts**: Define custom potion effects, amplifiers, durations, and permissions per boost. - **Multi-file configuration**: Clean separation of settings, GUI, boosts, and more for easy management. - **Interactive GUI**: Customizable inventory interface for boost activation. - **Per-boost cooldowns**: Prevents abuse and enables balanced gameplay. - **World restrictions**: Allow/deny boosts in specific worlds for tight gameplay tuning. - **Region-based overrides (WorldGuard)**: Apply different boost settings or disable boosts in specific WorldGuard regions using the override system. WorldGuard is detected automatically if present. - **Vault economy support**: Optionally charge players for activating boosts. - **Boost token items**: Give, trade, or reward boost tokens with `/ezboost give`. Players redeem tokens by right-clicking them to activate the boost. - **Live reload**: Reload all configuration and messages at runtime with `/ezboost reload`. - **MiniMessage support**: Rich formatting for all messages and GUI text. - **Internal message tags**: Boost-specific tags (`<boost_display>`, `<boost_cost>`, `<boost_duration>`, etc.) are available directly in `messages.yml` – no PlaceholderAPI required. - **PlaceholderAPI expansion**: 18+ placeholders covering boost status, active boost, cooldowns, time remaining, XP multiplier, and economy formatting, usable in scoreboards, GUI plugins, and any PAPI-compatible plugin. See the (https://ez-plugins.github.io/EzBoost/integration/PlaceholderAPI). - **Command hooks**: Run console commands on enable/disable/toggle per boost. - **Player-friendly behavior**: Reapply boosts on join, keep on death, and refund on failed activation. !(https://i.ibb.co/nsKmgK0H/image.png) !(https://i.ibb.co/ccjW6qFZ/image.png) --- ## ⚡ Commands | Command | Description | Permission | | --- | --- | --- | | `/boost` | Open the boosts GUI or show usage. | `ezboost.use` | | `/boost <boostKey>` | Activate a boost directly. | `ezboost.use` + boost permission | | `/boosttop` | View the top boost buyers leaderboard. | `ezboost.top` | | `/ezboost create` | Open the admin GUI to create boosts. | `ezboost.admin` | | `/ezboost reload` | Reload configuration and messages. | `ezboost.reload` | | `/ezboost give <player> <boostKey> ` | Give boost token items. Players redeem by right-clicking. | `ezboost.give` | For detailed command and permission documentation, see the (https://ez-plugins.github.io/EzBoost/commands) and (https://ez-plugins.github.io/EzBoost/permissions) pages. --- ## 🛡️ Permissions - `ezboost.use` – Use boosts (`/boost`). - `ezboost.top` – View the boost leaderboard (`/boosttop`). - `ezboost.admin` – Access admin commands. - `ezboost.reload` – Reload configuration. - `ezboost.give` – Give boost tokens. - `ezboost.cooldown.bypass` – Bypass boost cooldowns. - `ezboost.boost.<key>` – Per-boost permissions (example: `ezboost.boost.speed`). --- ## 🚀 Quick Start 1. Place `EzBoost.jar` in your server’s `plugins/` folder. 2. Start the server to generate all config files in `plugins/EzBoost/` (`settings.yml`, `boosts.yml`, `gui.yml`, `messages.yml`, etc.). 3. Use `/ezboost create` to open the admin GUI and create boosts. 4. Configure boosts, cooldowns, costs, and GUI slots in `plugins/EzBoost/boosts.yml`, `gui.yml`, and related config files. 5. Use `/boost` to open the GUI or `/boost <boostKey>` for instant activation. 6. Use `/ezboost give <player> <boostKey> ` to give boost tokens. Players redeem tokens by right-clicking them. 7. Grant per-boost permissions (like `ezboost.boost.speed`) to control access. --- ## ⚙️ Configuration Highlights - **Boost definitions**: Add or edit boosts in `boosts.yml` with effects, duration, cooldown, cost, and permissions. See the (https://ez-plugins.github.io/EzBoost/boosts) for a full reference. - **Command hooks**: Add `commands.enable`, `commands.disable`, or `c