diff --git a/MinecraftClient/Resources/ConfigComments/ConfigComments.resx b/MinecraftClient/Resources/ConfigComments/ConfigComments.resx
index 75879f54..e92415a9 100644
--- a/MinecraftClient/Resources/ConfigComments/ConfigComments.resx
+++ b/MinecraftClient/Resources/ConfigComments/ConfigComments.resx
@@ -193,7 +193,7 @@ You need to enable Entity Handling to use this bot
     <value>Capped between 1 to 4</value>
   </data>
   <data name="ChatBot.AutoAttack.Cooldown_Time" xml:space="preserve">
-    <value>How long to wait between each attack. Set "Custom = false" to let MCC calculate it.</value>
+    <value>Delay between attacks. Set "Custom = false" to let MCC calculate it. When Custom = true, set Min/Max for the cooldown range. If RandomMode = true, a random value between Min and Max is used for each attack.</value>
   </data>
   <data name="ChatBot.AutoAttack.Entites_List" xml:space="preserve">
     <value>All entity types can be found here: https://mccteam.github.io/r/entity/#L15</value>
diff --git a/docs/guide/chat-bots.md b/docs/guide/chat-bots.md
index ff12f19c..23658d54 100644
--- a/docs/guide/chat-bots.md
+++ b/docs/guide/chat-bots.md
@@ -354,19 +354,19 @@ redirectFrom:
 
   - **Description:**
 
-    How long to wait between each attack in seconds.
+    Controls the delay between attacks. By default, MCC calculates this based on server TPS. Set `Custom` to `true` to specify your own values:
 
-    To enable it, set `Custom` (boolean) to `true` and change `value` (double) to your preferred value (eg. `1.5`).
+    - `Min` — minimum cooldown in seconds
+    - `Max` — maximum cooldown in seconds
+    - `RandomMode` — if enabled, picks a random cooldown between `Min` and `Max` for each attack
 
-    By default, this is disabled and MCC calculates it based on the server TPS.
-
-  - **Format:** `Cooldown_Time = { Custom = <is enabled (true|false)>, value = <seconds (double)> }`
+  - **Format:** `Cooldown_Time = { Custom = <true|false>, RandomMode = <true|false>, Min = <seconds>, Max = <seconds> }`
 
   - **Type:** `inline table`
 
-  - **Example:** `Cooldown_Time = { Custom = true, value = 1.5 }`
+  - **Example:** `Cooldown_Time = { Custom = true, RandomMode = true, Min = 1.0, Max = 2.0 }`
 
-  - **Default:** `{ Custom = false, value = 1.0 }`
+  - **Default:** `{ Custom = false, RandomMode = false, Min = 1.5, Max = 2.5 }`
 
   #### `Interaction`