Configurable potion boosts for Spigot / Paper / Bukkit / Folia 1.21+ – GUI activation, cooldowns, economy costs, boost tokens, and WorldGuard region overrides.
EzBoost lets server owners offer time-limited potion boosts through a fully customisable chest GUI or direct commands. Every boost is independently configurable – potion effects, amplifier, duration, cooldown, permission, economy cost, and behaviour on death or reconnect. Boosts can be scoped to specific worlds or WorldGuard regions, and players can receive tradeable boost tokens as crate prizes or vote rewards.
- Chest GUI – browse boosts with live cooldown timers, cost display, and active-boost indicator
- Direct activation –
/boost <key>for players who prefer commands over the GUI - Boost tokens – physical inventory items redeemed by right-click; tradeable and giftable
- Rich feedback – MiniMessage-formatted actionbar and chat messages, fully customisable
- Fully configurable boosts – any potion effect, any amplifier, per-boost cooldown, permission, and cost
- In-game admin GUI – create and edit boosts with
/ezboost create, no YAML editing required - World allow / deny lists – restrict boosts to specific worlds for gameplay balance
- Region overrides – change any boost property (effect, cost, enabled state) per WorldGuard region; no hard dependency
- Live reload –
/ezboost reloadapplies all config changes without a server restart - Persistent storage – boost states and cooldowns survive restarts; choice of YAML, SQLite, MySQL, MariaDB, or PostgreSQL backend
- Boost top leaderboard –
/boosttopshows the top boost buyers, backed by persistent storage
- Folia – fully compatible; task scheduling routes through Folia's region schedulers when detected
- Vault – optional economy cost per boost; gracefully disabled if Vault is absent
- PlaceholderAPI – 18+ placeholders for scoreboards, holograms, and GUI plugins
- Internal message tags –
<boost_display>,<boost_cost>,<boost_duration>, and more available directly inmessages.yml
- Download
EzBoost-<version>.jarfrom the releases page. - Drop the JAR into your server's
plugins/folder. - Start (or restart) your server – EzBoost generates all config files in
plugins/EzBoost/. - Edit
boosts.ymlto define your boosts, then run/ezboost reloadto apply.
Optional extras:
- Enable economy costs in
economy.yml(requires Vault). - Switch the storage backend in
storage.yml(default: YAML; supports SQLite, MySQL, MariaDB, PostgreSQL).
| Command | Description | Permission |
|---|---|---|
/boost |
Open the boost GUI | ezboost.use |
/boost <key> |
Activate a boost directly | ezboost.use + boost node |
/boosttop |
View the top boost buyers leaderboard | ezboost.top |
/ezboost create |
Open the admin GUI | ezboost.admin |
/ezboost reload |
Reload all configuration | ezboost.reload |
/ezboost give <player> <key> [amount] |
Give boost tokens to a player | ezboost.give |
→ Full reference: Commands
| Permission | Description | Default |
|---|---|---|
ezboost.use |
Use /boost and the GUI |
true |
ezboost.top |
View the boost leaderboard | true |
ezboost.admin |
Admin commands and GUI | op |
ezboost.reload |
Reload configuration | op |
ezboost.give |
Give boost tokens | op |
ezboost.cooldown.bypass |
Skip cooldown checks | op |
ezboost.boost.<key> |
Activate a specific boost | true |
→ Full reference: Permissions
| File | Purpose |
|---|---|
boosts.yml |
Define boosts – effects, duration, cooldown, cost, permissions, command hooks |
settings.yml |
General toggles: replace-active-boost, keep-on-death, reapply-on-join |
limits.yml |
Clamp amplifier and duration ranges across all boosts |
worlds.yml |
World allow / deny lists |
economy.yml |
Vault economy enable / disable and cost settings |
gui.yml |
GUI title, size, filler items, and slot assignments |
messages.yml |
All MiniMessage-formatted feedback strings and actionbar text |
storage.yml |
Storage backend selection and connection settings |
→ Full reference: Configuration
Player boost states, cooldowns, and leaderboard data are persisted by Jaloquent.
Configure the backend in plugins/EzBoost/storage.yml:
| Backend | Notes |
|---|---|
yaml |
Default. Zero setup; data stored in flat files inside the plugin folder |
sqlite |
Single-file database; good for small-to-medium servers |
mysql |
Recommended for high-traffic or multi-server setups |
mariadb |
Drop-in MySQL-compatible alternative |
postgresql |
Full support; bring your own JDBC driver |
Boost tokens are inventory items that activate a specific boost when right-clicked in the main hand.
- Give tokens:
/ezboost give <player> <key> [amount] - Redeem: The player right-clicks the token – it is consumed and the boost activates immediately.
- Tokens work as crate prizes, vote rewards, auction house listings, or shop items.
EzBoost detects WorldGuard automatically. Use region IDs in boosts.yml to change any boost property
on a per-region basis – useful for PvP arenas, spawn zones, or event worlds.
If WorldGuard is not installed, region overrides are silently ignored.
→ Full reference: Overrides
Full documentation is at https://ez-plugins.github.io/EzBoost.
| Page | What it covers |
|---|---|
| Commands | All /boost and /ezboost commands |
| Permissions | Permissions reference and defaults |
| Configuration | All config files explained |
| Boosts | boosts.yml schema – effects, duration, costs |
| GUI | gui.yml layout and slot configuration |
| Overrides | World and region override syntax |
| Events | Plugin lifecycle events |
| Developer API | Java API reference |
| PlaceholderAPI | Available placeholders |
EzBoost exposes a Java API for starting/stopping boosts, querying active boost state, registering custom
effect types, and listening to lifecycle events (BoostStartEvent, BoostEndEvent).
<dependency>
<groupId>com.github.ez-plugins</groupId>
<artifactId>EzBoost</artifactId>
<version>2.1.0</version>
</dependency>→ Full reference: Developer API
EzBoost is licensed under the MIT License.