homechevron_rightOopchevron_rightCooldowns

Cooldowns

Cooldowns use a scoreboard objective that decrements every tick. When the score reaches 0 the cooldown is ready.

They are a good fit for abilities, interactions, item usage limits, or any mechanic that should be reusable for several players without hand-writing the decrement logic every time.

Registering a cooldown

val cd = registerCooldown("attack_cd", 2.seconds)

This generates:

A load function that creates the scoreboard objective.
A tick function that decrements the score for all players with score ≥ 1.

Typical usage pattern

function("dash_skill") {
	with(cd) {
		ifReady(player) {
			say("Dash!")
		}
	}
}

function("dash_hit") {
	cd.start(player)
}

This split keeps the “can I use it?” check separate from the event or action that actually starts the cooldown.

Using a cooldown

function("combat") {
	with(cd) {
		start(player)               // sets the score to the duration
		ifReady(player) {           // runs only when score == 0, then restarts
			say("Attack ready!")
		}
		reset(player)               // forces score to 0
	}
}

Function reference

Function	Description
`start`	Set the player score to the configured duration
`ifReady`	Run a block only when the cooldown is ready
`reset`	Force the cooldown back to `0`
tick hook	Auto-generated function that decrements active cooldown scores

linkCooldowns

linkRegistering a cooldown

linkTypical usage pattern

linkUsing a cooldown

linkFunction reference

linkSee also

Cooldowns

Registering a cooldown

Typical usage pattern

Using a cooldown

Function reference

See also