EzBoost

EzBoost

EzBoost is a modern, production-ready boosts plugin for Spigot / Paper / Bukkit 1.7–26.1.*. It delivers configurable potion effects with GUI activation, cooldown management, optional Vault costs, world-based restrictions, boost tokens, and advanced region-based overrides with WorldGuard support. It is a renewed take on EzBoost. EzBoost is a modern, production-ready boosts plugin for Spigot / Paper / Bukkit 1.7–26.1.*. It delivers configurable potion effects with GUI activation, cooldown management, optional Vault costs, world-based restrictions, boost tokens, and advanced region-based overrides with WorldGuard support. Inspired by %%MD1%%.

> EzBoost 2.0.0 and newer is build on Minecraft 26.1.2 and Java 25

---

📚 Documentation & Support

The GitHub repository is the main source for all documentation, guides, and updates: - The GitHub repository is the main source for all documentation, guides, and updates: - %%MD1%% - %%MD2%% - %%MD3%% - %%MD4%%

Need help or want to chat? Join our Discord: Need help or want to chat? Join our Discord:

For issues, feature requests, and the latest releases, always check GitHub first.

---

✨ Key Features

- Player-friendly behavior: Players can browse boosts with clear status, cooldown, and cost info. - Player-friendly behavior: Create and manage boosts through an intuitive admin interface. - Player-friendly behavior: Define custom potion effects, amplifiers, durations, and permissions per boost. - Player-friendly behavior: Clean separation of settings, GUI, boosts, and more for easy management. - Player-friendly behavior: Customizable inventory interface for boost activation. - Player-friendly behavior: Prevents abuse and enables balanced gameplay. - Player-friendly behavior: Allow/deny boosts in specific worlds for tight gameplay tuning. - Player-friendly behavior: Apply different boost settings or disable boosts in specific WorldGuard regions using the override system. WorldGuard is detected automatically if present. - Player-friendly behavior: Optionally charge players for activating boosts. - Player-friendly behavior: Give, trade, or reward boost tokens with `/ezboost give`. Players redeem tokens by right-clicking them to activate the boost. - Player-friendly behavior: Reload all configuration and messages at runtime with `/ezboost reload`. - Player-friendly behavior: Rich formatting for all messages and GUI text. - Player-friendly behavior: Boost-specific tags (`<boost_display>`, `<boost_cost>`, `<boost_duration>`, etc.) are available directly in `messages.yml` — no PlaceholderAPI required. - Player-friendly behavior: 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 Player-friendly behavior. - Player-friendly behavior: Run console commands on enable/disable/toggle per boost. - Player-friendly behavior: Reapply boosts on join, keep on death, and refund on failed activation.

---

⚡ Commands

| Command | Description | Permission | | --- | --- | --- | | `/boost` | Open the boosts GUI or show usage. | `ezboost.use` | | `/boost <boostKey>` | Activate a boost directly. | `ezboost.use` + boost permission | | `/ezboost create` | Open the admin GUI to create boosts. | `ezboost.admin` | | `/ezboost reload` | Reload configuration and messages. | `ezboost.reload` | | `/ezboost give <player> <boostKey> [amount]` | Give boost token items. Players redeem by right-clicking. | `ezboost.give` |

For detailed command and permission documentation, see docs/commands.md and docs/permissions.md.

---

🛡️ Permissions

- `ezboost.use` — Use boosts (`/boost`). - `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 `config.yml`, `messages.yml`, and `data.yml`. 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> [amount]` 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

- Economy: Add or edit boosts in `boosts.yml` with effects, duration, cooldown, cost, and permissions. See Economy for a full reference. - Economy: Add `commands.enable`, `commands.disable`, or `commands.toggle` per boost to run console commands when boosts turn on/off (supports `{player}`, `{displayname}`, and `{boost}` placeholders). - Economy: Customize title, size, filler, lore templates, and per-boost slot positions in `gui.yml`. - Economy: Clamp amplifier and duration ranges for balance in `limits.yml`. - Economy: Use `worlds.allow-list` / `worlds.deny-list` to control where boosts apply in `worlds.yml`. - Economy: Use `boosts.yml` to define per-world or per-region settings. If WorldGuard is installed, region overrides are applied automatically using region IDs. - Economy: Replace active boosts, reapply on join, keep on death, or refund failed activations in `settings.yml`. - Economy: Enable Vault costs with `economy.enabled` and `economy.vault` in `economy.yml`.

---

🌍 WorldGuard Integration & Region Overrides

- EzBoost automatically detects WorldGuard if present and applies region-based overrides for boosts. - No hard dependency: If WorldGuard is not installed, region overrides are ignored. - Use region IDs from WorldGuard in your `boosts.yml` to customize boost behavior per region. - See docs/overrides.md for syntax and examples.

---

✅ Recommended Use Cases

- World/region gating: Grant unique boosts per rank using per-boost permissions. - World/region gating: Distribute boost tokens as rewards. - World/region gating: Add costs to balance late-game progression. - World/region gating: Enable or disable boosts only in specific worlds or WorldGuard regions.

---

- EzBoost GitHub Repository — Source code, issues, and latest updates. - Configuration Guide — Full details on all config options. - Boosts Reference — YAML format and boost customization. - GUI Customization — How to configure the boost GUI. - Overrides Documentation — Region/world override syntax and examples.

Try the other Minecraft plugins in the EzPlugins series

--- For the latest documentation, advanced configuration, and troubleshooting, visit: https://github.com/ez-plugins/EzBoost