> For the complete documentation index, see [llms.txt](https://ads.darkplugins.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ads.darkplugins.de/plugin-settings/features/extras/custom-cooldowns.md).

# Custom Cooldowns

{% hint style="danger" %}
If a player has a custom cooldown, it will override their regular [<mark style="color:green;">global or player-specific cooldown</mark>](/plugin-settings/config/cooldowns.md), effectively acting as a bypass.
{% endhint %}

## Enabling custom cooldowns

`CustomCooldowns: 'false'`

You can enable this setting inside of the `features.yml`. You can use custom cooldowns for players with specific permissions. This can be used to give players a shorter or even longer cooldown than the default one.

## Adding custom cooldowns

{% hint style="info" %}
You can add / edit the custom cooldowns `./extras/custom_cooldowns.yml`
{% endhint %}

### Setup intructions:

* Each custom cooldown requires:&#x20;
  * Name
  * Permission
  * Cooldown period
* Custom cooldowns will override the [<mark style="color:green;">global and player-specific cooldowns</mark>](/plugin-settings/config/cooldowns.md) set in the `config.yml`.
* Define the cooldown duration in minutes.

### Example configuration

{% hint style="info" %}
The plugin processes configurations from top to bottom, so the highest rank should be listed at the top.
{% endhint %}

```
rank_a:
  permission: your.permission1
  cooldown: 1
rank_b:
  permission: your.permission2
  cooldown: 3
```