> For the complete documentation index, see [llms.txt](https://yowsef-development.gitbook.io/yowsef-development-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yowsef-development.gitbook.io/yowsef-development-docs/untitled/mechanics/cooldown-system.md).

# cooldown system

PrimeEnchants features a sophisticated "True Pulse" cooldown engine designed to be informative without being intrusive.

## 💓 True Pulse Engine

Unlike standard plugins that start a cooldown whenever you use an item, PrimeEnchants confirms success first.

* **Confirmation Logic**: A cooldown only starts if the enchantment actually triggers. For example, if you have *Vampiric* on your sword but you are already at full health, the engine will NOT start the cooldown, allowing you to save it for when you actually need it.
* **Passive Pulse**: Armor and accessory enchantments check their cooldown **before** attempting to run. This prevents the "infinite loop" bug where passive effects would constantly spam your action bar even while cooling down.

## 📺 Action Bar HUD

Stay informed about your gear's readiness in real-time.

* **Throttled Notifications**: "On Cooldown" messages are restricted to once every 2.5 seconds per enchantment. This prevents the action bar from "vibrating" or flickering when you are rapidly using an item.
* **Ready! Flashes**: When a cooldown finishes, the enchantment name will flash **GREEN** on your action bar for 1 second. This clear visual cue lets you know you're back at full power.
* **Multi-Enchant HUD**: If you have multiple items cooling down, the HUD will list them all, separated by configurable symbols.

## ⚙️ Configuration

You can customize the symbols and colors used in the HUD via the `messages` section in `config.yml`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://yowsef-development.gitbook.io/yowsef-development-docs/untitled/mechanics/cooldown-system.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.