# Chat Cooldown

## About this module

The Intelligent Chat Cooldown
 module controls how quickly players can send messages and configured or all commands within a defined time frame.

{% hint style="info" %}
To bypass this module, op or the permission: "**chatsentry.chatcooldown.bypass"** is required. 
{% endhint %}

## Config guide

You can access the below settings in the **chat-cooldown.yml** file within the **modules** folder of the plugin's root folder.

{% hint style="success" %}
**Config excerpts taken from v3.6.0 and may not be completely up-to-date with the latest changes. To see the most up-to-date file, see below:**
{% endhint %}

{% content-ref url="/pages/-MOrmZn1f\_p\_TEBNNyqO" %}
[chat-cooldown.yml](/files/files/module-configurations/chat-cooldown.yml.md)
{% endcontent-ref %}

###

### chat-cooldown-in-ticks

Below is the duration of time the options below this option will apply to

{% hint style="success" %}
20 ticks ***=*** 1 second

160 ticks ***=*** 8 seconds
{% endhint %}

```yaml
chat-cooldown-in-ticks: 160
```

### allowed-message-sends-per-cooldown

How many messages can players send every chat-cooldown-in-ticks amount of time?

```yaml
allowed-message-sends-per-cooldown: 4
```

### allowed-affected-command-runs-per-cooldown

How many commands on the below affected-commands list can players send every chat-cooldown-in-ticks amount of time?

```yaml
allowed-affected-command-runs-per-cooldown: 6
```

### affected-commands

{% hint style="warning" %}
The below list will only work if "process-commands" is true in config.yml
{% endhint %}

### 

The below list is which commands the module will apply to. It's recommended to only set these to your private messaging commands.

Set the list to "affected-commands: \[]" to apply the module to ALL commands (highly not recommended!)

Make sure to only include base commands; don't add any command arguments. (spaces)

```yaml
affected-commands:
  - "/tell"
  - "/t"
  - "/msg"
  - "/w"
  - "/r"
  - "/whisper"
  - "/w"
  - "/pm"
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.chatsentry.xyz/config-guides/module-config-guides/chat-cooldown.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.