> For the complete documentation index, see [llms.txt](https://wiki.arkvalkyrie.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.arkvalkyrie.com/server-features/autopot-system.md).

# Autopot System

The **Autopot System** automatically drinks your HP or SP potions whenever your HP or SP falls below a percentage you choose. No more spam-clicking potions in the middle of a fight set it once and focus on the battle.

While Autopot is running, you will see a **status icon** on your buff bar for each active type (HP Autopot and SP Autopot), so you always know it's working.

### How to Use

Type the command:

```
@autopots
```

A menu will open with the following options:

#### 1. Start / Stop

Turns the Autopot on or off. You must set at least one potion (HP or SP) before you can start it.

* When started, the HP and/or SP Autopot **status icons** appear on your buff bar.
* When stopped, the icons are removed.

#### 2. Set Potion

Choose whether to configure your **HP Potion** or **SP Potion**. The NPC will list every valid potion currently in your inventory, including special variants:

* **(BG)** — Battleground-only potions
* **(WOE)** — War of Emperium-only potions
* **(PVP)** — PVP-only potions

After picking a potion, enter your **threshold percentage (5–100%)**. Example: if you set your HP threshold to `90`, the system drinks a potion whenever your HP drops below 90%.

{% hint style="info" %}
The system consumes the **exact potion you selected**. If you carry both a normal White Potion and a (BG) White Potion, only the variant you picked will be used the other stack is never touched.
{% endhint %}

**Clearing a potion:** If a potion is already set, a red **\[ Clear ]** option appears at the top of the list. Use it to remove the HP or SP setting individually. If that type is currently running, it stops and its icon is removed — the other type keeps running normally.

#### 3. Set Delay

Sets how often the system checks your HP/SP, in milliseconds (**100–1000 ms**). A lower delay reacts faster; a higher delay is more relaxed. On first use, the delay defaults to the maximum value.

#### 4. Check Config

Shows your current setup: selected HP/SP potions (with variant labels), thresholds, delay, and whether the system is currently **RUNNING** or **STOPPED**.

### Important Behavior

* **Restricted potions and maps.** BG, WOE, and PVP potions only work on their matching maps. If you're on the wrong map, the system **skips** drinking and warns you **once** it does **not** stop. As soon as you enter a valid map (or the potion becomes usable again), it automatically resumes.
* **Runs out of potions?** If you run out of your selected HP potion, only the **HP** side is disabled (and its icon removed) your SP Autopot keeps running, and vice versa. You'll get a message telling you which one was disabled and why.
* **Status conditions.** The system will not drink while you are under effects that normally prevent item use, such as Berserk, Stone, Freeze, Stun, Sleep, Trick Dead, Hiding, Shadow Form, Invisibility, Manhole, or Kagehumi. It resumes automatically once the effect ends.
* **Death and logout.** Autopot fully stops when you die or log out. You'll need to start it again with `@autopots`.

### FAQ

**Q: I started Autopot but nothing is happening.** Check that your HP/SP is actually below your threshold the system only drinks when you drop under the percentage you set. Also use *Check Config* to confirm a potion is set and the status says RUNNING.

**Q: It says my potion "cannot be used on this map."** You selected a BG, WOE, or PVP variant and you're not on a matching map. Either move to the correct map or set a normal (untagged) potion instead. The system stays running and resumes on its own.

**Q: My Autopot suddenly turned off.** You most likely ran out of that potion, or you died/logged out. Restock and start it again with `@autopots`.

**Q: Does it work with tagged potions like (BG) White Potion?** Yes and it will only ever consume the exact variant you selected.


---

# 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://wiki.arkvalkyrie.com/server-features/autopot-system.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.
