How It Works

1. A cooldown must already be active (set by $cooldown, $serverCooldown, or $globalCooldown earlier in the same command).
2. Calling $changeCooldownTime replaces the remaining time — not the total original duration.
3. The new duration is applied immediately.

Important Notes

• Must be called after a cooldown is set. If no cooldown is active, calling $changeCooldownTime has no meaningful effect.
• Replaces the remaining time, not the original duration. For example, if a 60s cooldown has 45s left, $changeCooldownTime[10s] sets it to 10s remaining (not adds 10s).
• Works with all cooldown scopes: modifies whichever cooldown was most recently set (user, server, or global).

Common Use Cases

Adaptive Rate Limiting

Increase the cooldown for users who trigger anti-spam rules:

$cooldown[30s]
$if[$messageLength>500]
$changeCooldownTime[5m]
$sendMessage[⚠️ Long messages: cooldown extended to 5 minutes.]
$endif

Admin Bypass

Admins can reset their cooldown:

$cooldown[60s;⏳ Cooldown active.]
$if[$hasPerms[$authorID;Administrator]]
$changeCooldownTime[1s]
$sendMessage[🔓 Cooldown bypassed (admin).]
$endif

Duration Format

Same format as $cooldown: Xs for seconds, Xm for minutes, Xh for hours, Xd for days, Xms for milliseconds. Combined formats like 2m30s are also supported.

Examples

Reducing Cooldown for VIP Members

$cooldown[10m;⏳ Slow down! Cooldown active.]
$if[$hasRole[$authorID;123456789012345678]==true]
  ;; VIP role members get a reduced cooldown of 1 minute
  $changeCooldownTime[1m]
$endif
$title[Daily Reward Claimed]
$description[You received **100 coins**! VIP members have a reduced 1m cooldown.]
$color[#57F287]
$sendMessage[]