> 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/core-features/auto-potions.md).

# Auto Potions

Never die from forgetting to pot again! The auto potion system provides intelligent, multi-tier HP and SP recovery.

***

## ❤️ HP Recovery

Configure up to **5 tiers** of HP recovery items, each with independent thresholds for maximum survival.

### Configuration

| Setting       | Description                              |
| ------------- | ---------------------------------------- |
| **Key**       | Hotkey for the potion (F1-F9, 1-0, etc.) |
| **Threshold** | HP percentage to trigger usage           |
| **Delay**     | Cooldown between uses                    |

### Example Setup

{% hint style="success" %}
**Recommended Configuration** — Set up a tiered system from common potions to emergency items.
{% endhint %}

| Tier | Threshold | Suggested Item    |
| :--: | :-------: | ----------------- |
|   1  |    70%    | White Potions     |
|   2  |    50%    | Yellow Potions    |
|   3  |    30%    | Mastela Fruit     |
|   4  |    20%    | Yggdrasil Berry   |
|   5  |    10%    | Emergency Reserve |

### How Priority Works

The system checks from Tier 1 downward. When your HP drops, it uses the **most appropriate tier** based on your current HP percentage.

***

## 💙 SP Recovery

Configure up to **3 tiers** of SP recovery items for uninterrupted skill usage.

### Example Setup

| Tier | Threshold | Suggested Item  |
| :--: | :-------: | --------------- |
|   1  |    50%    | Blue Potions    |
|   2  |    30%    | Grape Juice     |
|   3  |    10%    | Yggdrasil Berry |

***

## 🪑 Auto Sit

Save potions by automatically sitting when idle to recover HP/SP naturally.

### Settings

| Setting          | Description                            |
| ---------------- | -------------------------------------- |
| **HP Threshold** | Sit when HP drops below this %         |
| **SP Threshold** | Sit when SP drops below this %         |
| **Stand HP**     | Stand up when HP recovers above this % |
| **Stand SP**     | Stand up when SP recovers above this % |

{% hint style="info" %}
**Pro Tip:** Auto Sit is great for conserving potions during downtime between monster spawns.
{% endhint %}

***

## 💡 Tips & Best Practices

<details>

<summary><strong>Optimizing Your Potion Setup</strong></summary>

1. **Use cheaper potions first** — Set higher thresholds for common potions
2. **Reserve expensive items** — Use Yggdrasil Berries only for emergencies (10-20%)
3. **Match your build** — Casters need more SP tiers, tanks need more HP tiers
4. **Test your delays** — Too fast may waste potions, too slow may get you killed

</details>

<details>

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

| Potion Type     | Suggested Delay |
| --------------- | --------------- |
| Regular Potions | 300-500ms       |
| Healing Items   | 500-800ms       |
| Yggdrasil Berry | 1000ms          |

</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/core-features/auto-potions.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.