BotCommands/io.github.freya022.botcommands.api.commands.annotations/Cooldown

Cooldown

@Target(allowedTargets = [AnnotationTarget.CLASS, AnnotationTarget.FUNCTION])
annotation class Cooldown(val cooldown: Long = 0, val unit: ChronoUnit = ChronoUnit.MILLIS, val rateLimitScope: RateLimitScope = RateLimitScope.USER, val deleteOnRefill: Boolean = true)(source)

Add a simple rate limit-based cooldown of this text / application command and components.

Text commands note: This applies to the command itself, not only this variation, in other words, this applies to all commands with the same path.

Cooldown cancellation

The cooldown can be cancelled inside the command with CancellableRateLimit.cancelRateLimit on your event.

See also

@RateLimit

In-command equivalent

Code-declared equivalent

Properties

Link copied to clipboard
val cooldown: Long = 0

Cooldown time in the specified unit before the command can be used again in the scope specified by rateLimitScope.

Link copied to clipboard
val deleteOnRefill: Boolean = true

Whether the cooldown message should be deleted after the cooldown has expired.

Link copied to clipboard
val rateLimitScope: RateLimitScope

Scope of the cooldown, see RateLimitScope values.

Link copied to clipboard
val unit: ChronoUnit

The time unit of the cooldown