Interfaceseedcordv0.15.0

CooldownOptions

Options for CooldownCooldown. perper sets the bucket the window applies to and limitlimit the uses allowed per window. messagemessage rewords the refusal and noticenotice replaces it, both receiving the epoch ms the key frees up so the refusal can show the retry time.

interface CooldownOptions

interface CooldownOptions

// one use per channel, rewording the refusal with the retry time
Cooldown('10s', {
    per: 'channel',
    message: (expires) => `Slow down. Try again <t:${Math.round(expires / 1000)}:R>.`
});

// one use per channel, rewording the refusal with the retry time
Cooldown('10s', {
    per: 'channel',
    message: (expires) => `Slow down. Try again <t:${Math.round(expires / 1000)}:R>.`
});

// five uses per minute, per user
Cooldown('1m', { limit: 5 });

// five uses per minute, per user
Cooldown('1m', { limit: 5 });

optional

limit

Uses allowed inside one window before the gate refuses.

limit: number;

limit: number;

Default:11

optional

message

Reword the refusal, keeping the standard notice card. Receives the epoch ms the key frees up, so the text can include the retry time with <t:${Math.round(expires / 1000)}:R><t:${Math.round(expires / 1000)}:R>.

message: (expires: EpochMs) => string;

message: (expires: EpochMs) => string;

optional

notice

Replace the refusal Notice entirely, for full control or a translated copy. Receives the epoch ms the key frees up.

notice: (expires: EpochMs) => Notice;

notice: (expires: EpochMs) => Notice;

optional

per

The bucket the cooldown window applies to. 'user' scopes by user ID, 'guild' scopes by guild ID (falls back to global if no guild), and 'channel' scopes by channel ID (falls back to global if no channel). If your handler can run in DMs and you want a per-user cooldown, use 'user' and it won't charge a shared global bucket for users without IDs.

per: "user" | "guild" | "channel";

per: "user" | "guild" | "channel";

Default:'user''user'