
EzBoost
The ultimate token-based booster system. Create custom speed, movement, and gameplay buffs for your players.
Added
- Guardian preset boost (
guardian): built-in totem-style defensive boost with default effects (DAMAGE_RESISTANCE,HEALTH_BOOST) and preconfigured GUI slot. - Per-boost revive options in
boosts.yml:revive-enabled(defaultfalse)revive-hearts(default4.0, clamped to safe bounds)
- Lethal-hit interception for revive-enabled boosts: when incoming damage would be fatal, death is prevented, configured health is restored, and the active boost is consumed immediately (single-use per activation).
- Guardian hover preview screenshot:
/boostGUI hover state for Guardian added to release/listing visuals.

- Guardian preset boost (
Added
- Folia compatibility: EzBoost now supports Folia servers via a
FoliaSchedulerabstraction that routes task scheduling through Folia'sGlobalRegionScheduler/ entity schedulers when the Folia runtime is detected. - Boost top leaderboard (
/boosttop): tracks and displays the top boost buyers using a Jaloquent-backed persistent storage layer. - Jaloquent storage backend: replaced the previous
BoostStorageabstraction with a fully Jaloquent-backedEzBoostRepositoryfor consistent flat-file persistence across all storage operations. storage.debug-loggingoption (storage.yml, defaultfalse): suppresses verbose Jaloquent console output (Queried X rows,Saved model…). Set totrueto re-enable for debugging.- Paper 1.21 smoke-test: CI matrix now includes Paper 1.21.11 alongside Paper 26.1.2, Folia, Spigot, and Bukkit.
Changed
api-versionlowered from26.1.2to1.13so the plugin loads on any Spigot/Paper 1.13+ server without an api-version warning or rejection.- Java compiler target lowered from 25 to 17 for wider JDK compatibility.
AsyncChatEvent(Paper-only) replaced withAsyncPlayerChatEventfor Spigot compatibility.- Plugin version lookup changed from
getPluginMeta().getVersion()togetDescription().getVersion()for broader server compatibility. - CI smoke-test pass condition now also verifies
Enabling EzBoostappears in the server log, preventing a false pass when the server starts but rejects the plugin due to an incompatible api-version.
Fixed
YamlDataStore.query()corrected to handle Jaloquent's flat key format.storage.ymladded topom.xmlresource includes so it is correctly packaged.- Vault is now fully optional: economy class access and listener registration are guarded so the plugin loads cleanly without Vault present.
- Folia compatibility: EzBoost now supports Folia servers via a
Minecraft 26.1.2 & Java 25
The plugin has been updated to Minecraft 26.1.2 and Java 25
Placeholders & Messages
New internal message tags (no PlaceholderAPI required)
Boost-context messages in
messages.ymlnow support additional tags automatically. You can use these in any message that relates to a specific boost:Tag Example output <boost>/<boost_display>Speed Boost<boost_key>speed<boost_cost>50,000<boost_cost_compact>50K<boost_cost_raw>50000<boost_duration>120<boost_cooldown>60Available in:
boost-activated,boost-expired,boost-cooldown,boost-effect-cooldown,insufficient-funds,cost-charged,token-used.Bug fix:
<boost>now shows display name everywherePreviously
boost-expired,cost-charged, andtoken-usedshowed the internal config key (e.g.speed) instead of the configured display name (e.g.Speed Boost). This is now fixed. Use<boost_key>if you specifically need the raw config key.9 new PlaceholderAPI placeholders
Requires PlaceholderAPI to be installed.
Placeholder Returns %ezboost_has_active_boost%trueorfalse%ezboost_active_boost%Config key of the active boost, or empty %ezboost_active_boost_display%Display name of the active boost, or empty %ezboost_active_boost_time_remaining%Seconds remaining as a number %ezboost_active_boost_time_remaining_formatted%MM:SSorHH:MM:SS%ezboost_is_active_<boostkey>%trueorfalse%ezboost_cooldown_remaining_<boostkey>%Cooldown seconds as a number %ezboost_cooldown_remaining_formatted_<boostkey>%MM:SSorHH:MM:SS%ezboost_xp_multiplier%Active XP multiplier ( 1if no XP boost is running)Example uses:
- Scoreboard line:
Boost: %ezboost_active_boost_display% (%ezboost_active_boost_time_remaining_formatted%) - Condition check: show a button only when
%ezboost_has_active_boost%equalsfalse - XP display:
XP rate: %ezboost_xp_multiplier%x
- Scoreboard line:
New Boosts
11 new preset boosts have been added and are available out of the box:
Key Display Name Effects waterbreathingWater Breathing Boost Water Breathing saturationSaturation Boost Saturation luckLuck Boost Luck absorptionAbsorption Boost Absorption II slowfallSlow Falling Boost Slow Falling minerMiner Boost Haste III + Night Vision warriorWarrior Boost Strength II + Absorption II farmerFarmer Boost Saturation + Luck explorerExplorer Boost Speed II + Jump Boost II xpboostXP Boost 2× XP multiplier (custom effect) diverDiver Boost Water Breathing + Dolphin's Grace + Conduit Power All new boosts are disabled by default. Enable them in
boosts.ymland assign slots ingui.yml. Each boost requires the corresponding permission node, e.g.ezboost.boost.waterbreathing.Notes
- The XP Boost uses a custom effect (
xpboost) that multiplies experience gained. Amplifier 0 = 2× XP, amplifier 1 = 3× XP, and so on. - The Miner, Warrior, Farmer, Explorer, and Diver boosts are combo boosts that apply multiple effects simultaneously.
- The XP Boost uses a custom effect (
- Fixed optional Placeholder registration, plugin did not start up when PlaceholderAPI was missing
- Fixed autocomplete of the
/boostcommand
What's Changed
- Added money formatting (
1k,2b,3t) by @ez-plugins in https://github.com/ez-plugins/EzBoost/pull/27 - Added
/ezboost aboutsubcommand by @ez-plugins in https://github.com/ez-plugins/EzBoost/pull/29 - feat: added PlaceholderAPI expansion by @ez-plugins in https://github.com/ez-plugins/EzBoost/pull/28
Full Changelog: https://github.com/ez-plugins/EzBoost/compare/1.5.4...1.5.5
- Added money formatting (
- Added
show-effectsoption (defaultfalse) to hide potion effects
- Added
- Removed parent from
pom.xml - Removed debug messages when no effects applied to custom effect
- Removed parent from
- Fixed issue loading custom effects that weren't registered yet.
- Added EzShops as softdepend
- Improved
/ezboostcommand autocomplete to not display subcommands you do not have permission for - Improved
BoostEffectclass by adding the name to the object class for better reusage and later expension
- Improved
- Added admin GUIs to create new boosts and add them to the boost selection GUI more easily

- Added
/ezboost createsubcommand to open the GUI - Added
/ezboost create continuesubcommand
- Added
CustomBoostEffectinterface:docs/api/CustomBoostEffect.md - Added
EzBoostAPIfor registering custom boosts - Added
BoostStartEventfor easier managing of the boosts - Added
BoostEndEventfor easier managing of the boosts - Added full API documentation:
docs/api.md
Check Github: EzBoost repository on Github.com
- Added
