EzBoost

EzBoost

EzBoost is a lightweight boosts plugin for Paper 1.7–1.21. It delivers configurable potion effects with GUI activation, cooldown management, optional Vault costs, and world-based restrictions. It is a renewed take on RedBull.

✨ Key Features

• GUI-first activation: Players can browse boosts with clear status, cooldown, and cost info.
• Fully configurable boosts: Define custom potion effects, amplifiers, durations, and permissions per boost.
• Cooldown controls: Per-boost cooldowns and optional per-type cooldown tracking.
• Optional Vault economy: Charge currency per boost or run everything free.
• World restrictions: Allow/deny specific worlds for tight gameplay tuning.
• Player-friendly behavior: Reapply boosts on join, keep on death, and refund on failed activation.

⚡ Commands

🛡️ 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. Configure boosts, cooldowns, costs, and GUI slots in plugins/EzBoost/config.yml.
4. Use /boost to open the GUI or /boost <boostKey> for instant activation.
5. Grant per-boost permissions (like ezboost.boost.speed) to control access.

⚙️ Configuration Highlights

• Boost definitions: Add boosts under boosts with effects, duration, cooldown, cost, and permissions.
• Command hooks: 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).
• GUI layout: Customize title, size, filler, lore templates, and per-boost slot positions.
• Limits: Clamp amplifier and duration ranges for balance.
• World rules: Use worlds.allow-list / worlds.deny-list to control where boosts apply.
• Behavior toggles: Replace active boosts, reapply on join, keep on death, or refund failed activations.
• Economy: Enable Vault costs with economy.enabled and economy.vault.

✅ Recommended Use Cases

• Rank perks: Grant unique boosts per rank using per-boost permissions.
• Crates & events: Distribute boost tokens as rewards.
• Economy sinks: Add costs to balance late-game progression.
• World gating: Enable boosts only in specific worlds or arenas.