> For the complete documentation index, see [llms.txt](https://xgine.gitbook.io/xgine-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xgine.gitbook.io/xgine-docs/skills-and-automation/macros.md).

# Macros

Automate complex skill sequences with custom macros! Create combos, spam skills, and execute perfect rotations every time.

***

## 🎯 Overview

The Macro system lets you:

* **Spam skills** — Rapidly press keys for maximum DPS
* **Chain combos** — Execute perfect skill sequences
* **Animation cancel** — Optimize skill timing

***

## ⚡ Macro Types

### Skill Spam Cancel (SSC)

Rapidly alternate between skill and cancel keys for animation canceling:

| Setting        | Description             |
| -------------- | ----------------------- |
| **Skill Key**  | The skill to spam       |
| **Cancel Key** | Key to cancel animation |
| **Delay**      | Time between presses    |

{% hint style="success" %}
**Pro Tip:** Animation canceling can significantly increase your DPS on certain skills!
{% endhint %}

### Skill Spam (SS)

Simple key repetition for skills without animation cancel:

| Setting   | Description          |
| --------- | -------------------- |
| **Key**   | The key to repeat    |
| **Delay** | Time between presses |

***

## 🔗 Chain Macros

Execute a sequence of skills in perfect order — great for buff rotations!

### Configuration

| Setting         | Description               |
| --------------- | ------------------------- |
| **Trigger Key** | Key that starts the chain |
| **Chain Keys**  | Sequence of keys to press |
| **Delays**      | Time between each key     |

### Example: Lord Knight Buff Chain

| Step | Skill         | Purpose           |
| :--: | ------------- | ----------------- |
|   1  | Concentration | ATK boost         |
|   2  | Aura Blade    | Additional damage |
|   3  | Endure        | Flinch resistance |

{% hint style="info" %}
Press one key and watch your character execute the entire buff rotation automatically!
{% endhint %}

***

## 📦 Macro Sets

Configure up to **2 macro sets** with **5 keys each** — perfect for different situations or characters.

| Set       | Use Case                 |
| --------- | ------------------------ |
| **Set 1** | Primary farming rotation |
| **Set 2** | Boss/MVP rotation        |

***

## 🎮 Activation Methods

| Method            | Description                   |
| ----------------- | ----------------------------- |
| **Toggle Switch** | Enable/disable from the UI    |
| **Hotkey**        | Assign a key to toggle macros |
| **Condition**     | Auto-trigger based on HP/SP   |

***

## ⌨️ Disable Chat on Keypress

Prevent accidental typing in chat when macros or autobuff trigger:

| Setting      | Description                                                |
| ------------ | ---------------------------------------------------------- |
| **Enabled**  | Automatically closes chat window before sending keypresses |
| **Disabled** | Normal behavior — keypresses may type in chat if open      |

{% hint style="success" %}
**Recommended:** Enable this setting if your server's chat input intercepts hotkey presses, preventing macros from working correctly.
{% endhint %}

***

## 💡 Best Practices

<details>

<summary><strong>Optimizing Your Macros</strong></summary>

1. **Test Your Delays** — Find the sweet spot for your connection
2. **Avoid Key Conflicts** — Don't use the same keys as auto-pot
3. **Order Matters** — Put buffs before attack skills in chains
4. **Start Simple** — Begin with basic macros before complex chains
5. **Enable Disable Chat on Keypress** — Prevents chat from intercepting your macro keys

</details>

<details>

<summary><strong>Recommended Delay Settings</strong></summary>

| Connection             | Suggested Delay |
| ---------------------- | --------------- |
| Low Ping (<50ms)       | 100-150ms       |
| Medium Ping (50-150ms) | 150-250ms       |
| High Ping (>150ms)     | 250-400ms       |

</details>


---

# 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, and the optional `goal` query parameter:

```
GET https://xgine.gitbook.io/xgine-docs/skills-and-automation/macros.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.