EnderPearlz | Now with bossbar!! | FULLY RECODED!!

EnderPearlz
Highly configurable Ender Pearl cooldown plugin

______________________________________________________________________

Tested on: 1.8 – Latest (Spigot / Paper)

______________________________________________________________________
✔ Features

• Global Ender Pearl cooldown
• Fully configurable messages & sounds
• Optional BossBar progress display
• Per-world enable / disable
• Bypass & admin permissions
• Lightweight and version-safe

______________________________________________________________________
⚙ Configuration

# Global cooldown in seconds
cooldown:
  enabled: true
  default: 15
  per-world:
    enabled: false
    worlds:
      world: 10
      world_nether: 20
# BossBar settings (for supported versions)
bossbar:
  enabled: true
  title: "&dEnder Pearl Cooldown: &f{time_left}s"
  color: "PURPLE"
  style: "SEGMENTED_10"
  only-show-when-cooling: true
messages:
  prefix: "&8[&5EnderPearlz&8] "
  on-cooldown: "&cYou must wait &f{time_left}&cs before throwing another Ender Pearl!"
  ready: "&aYour Ender Pearl is ready again!"
  no-permission: "&cYou don't have permission to do that."
  reloaded: "&aConfig reloaded."
  cooldown-set: "&aGlobal cooldown set to &f{seconds}s&a."
  cooldown-get: "&aCurrent global cooldown: &f{seconds}s&a."
  bossbar-toggled-on: "&aBossBar cooldown display: &aON"
  bossbar-toggled-off: "&aBossBar cooldown display: &cOFF"
# Time formatting
time-format:
  enabled: true
  # {s} seconds, {m} minutes, {h} hours
  format-under-minute: "{s}s"
  format-under-hour: "{m}m {s}s"
  format-above-hour: "{h}h {m}m {s}s"
sounds:
  on-cooldown:
    enabled: true
    sound: "BLOCK_NOTE_BLOCK_BASS"
    volume: 1.0
    pitch: 1.0
  ready:
    enabled: true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
    volume: 1.0
    pitch: 1.4

______________________________________________________________________
⌨ Commands

• /epcooldown – Main command
• /epcooldown reload – Reload configuration
• /epcooldown set <seconds> – Set global cooldown
• /epcooldown get – View current cooldown
• /epcooldown togglebossbar – Toggle BossBar display

Permissions

• enderpearlcooldown.admin – Use all admin subcommands
• enderpearlcooldown.bypass – Bypass Ender Pearl cooldown

______________________________________________________________________
Installation

1. Download the latest EnderPearlz jar.
2. Drop it into your /plugins folder.
3. Start or restart your server.
4. Edit the generated config.yml to your liking.
5. Use /epcooldown reload to apply changes.

______________________________________________________________________
✅ Compatibility Notes

• BossBar automatically adapts to your server version.
• Uses safe Bukkit/Paper APIs, no NMS required.

Suggestions and feedback are welcome.