ParadoxCooldown

About

ParadoxCooldown is a lightweight Spigot plugin that adds configurable item cooldowns with an ActionBar message.

When a player tries to use an item that is on cooldown, the usage is blocked and the player sees:

• <display> cooldown <time>s

When the player uses an item successfully, the player sees:

• Cooldown for <display> <time>s

Features

Configurable cooldowns

• Add any item to the config (by material name).
• Set a cooldown duration in seconds.
• Set a custom display name so it does not show ENDER_PEARL, FIREWORK_ROCKET, etc.

Firework rockets (duration / power)

Firework rockets can have different flight duration based on their power (1–3).

You can set a different cooldown per power via by-power.

Colors in display names

Display names support:

• & color codes (example: &b, &f, &c, &l, &r)
• Hex colors using &#RRGGBB (example: &#1FA3FF)

Installation

1. Put ParadoxCooldown-1.0.0.jar into your server plugins/ folder.
2. Start the server once to generate the config.
3. Edit plugins/ParadoxCooldown/config.yml.
4. Restart the server.

Commands

No commands.

Permissions

No permissions.

Configuration (config.yml)

File location:

• plugins/ParadoxCooldown/config.yml

Example config

cooldowns:
  ender_pearl:
    item: ENDER_PEARL
    display: "&bEnder &fPearls"
    seconds: 10

  rockets:
    item: FIREWORK_ROCKET
    display: "&#1FA3FFRockets"
    seconds: 10
    by-power:
      "1": 1
      "2": 2
      "3": 3

Settings

cooldowns

Top-level map of cooldown entries. The key name (ender_pearl, rockets, etc.) is just an identifier and can be anything.

Each entry supports:

• item (string)
  • Bukkit/Spigot material name (example: ENDER_PEARL, GOLDEN_APPLE, FIREWORK_ROCKET)
• display (string)
  • The display name shown in the ActionBar messages
  • Supports colors:
    • & codes (example: &bEnder &fPearls)
    • Hex: &#RRGGBB (example: &#1FA3FFRockets)
• seconds (number)
  • Default cooldown duration for this item (in seconds)
  • Used if no more specific override matches

Optional overrides:

• by-power (map)
  • Only applies to FIREWORK_ROCKET
  • Lets you set different cooldowns based on rocket power (duration)
  • Keys must be "1", "2", "3" (strings in YAML), values are seconds
• per-day (map)
  • Optional override by day of week
  • Keys: MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY
  • Values: seconds
  • If set, it overrides seconds for that day

Notes

• Cooldowns are stored in memory per-player and reset on server restart.
• Materials are case-insensitive in config (the plugin uppercases them internally).
• If an entry is invalid (unknown material or seconds <= 0), it is ignored and a warning is logged to console.

---

Created by Paradox