> For the complete documentation index, see [llms.txt](https://wiki.mypet-plugin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.mypet-plugin.com/setup-guide/skilltree-creation/creating-custom-skilltrees/skills/potion.md).
# Potion
Let your Pet throw splash potions — buffs for you, debuffs for your enemies.
The Potion skill turns your Pet into a field alchemist. The skilltree grants, per level, **which splash potions the Pet may throw** — its *arsenal* — and gives each one its own cooldown. The Pet throws from real potions in its [Backpack](/setup-guide/skilltree-creation/creating-custom-skilltrees/skills/backpack.md) and aims each one automatically:
* **Helpful** potions (Healing, Strength, Speed, Fire Resistance, Night Vision, Regeneration, Water Breathing, …) are thrown at **you**.
* **Harmful** potions (Harming, Poison, Weakness, Slowness) are thrown at the **enemy your Pet is fighting**.
The Pet picks the most useful potion for the moment — an emergency heal outranks an attack, which outranks a buff — and throws **one per second** at most, so it never empties its cooldowns all at once. It only throws while it is spawned, you are online and within **16 blocks**, and it has a clear line of sight to the target — it won't waste a potion against a wall.
The Pet is never caught in its own splash, and **you are never hit by a harmful potion your Pet throws at an enemy**, even if you are standing right next to it. The Pet throws **the actual bottle you stocked**, so its strength and duration are whatever you provide — stock Splash Healing II and it throws Healing II. A grant is matched by **effect**, not exact tier: a "Healing" grant is satisfied by any healing splash potion you put in the backpack.
### Who gets hit
Harmful potions follow your Pet's **behaviour mode** (set in the pet menu, `/pet`) — the same setting that decides what your Pet attacks:
| Behaviour | Harmful potions thrown at… |
| ---------- | --------------------------------------------------- |
| Friendly | nobody — the Pet only throws helpful potions at you |
| Normal | a mob once it attacks you or your Pet |
| Aggressive | nearby hostile mobs, on sight |
| Raid | monsters, following raid targeting |
| Farm | the animal your Pet is farming |
| Duel | the duel opponent |
### Stocking potions
By default the Pet needs the **actual splash potion in its** [**Backpack**](/setup-guide/skilltree-creation/creating-custom-skilltrees/skills/backpack.md) to throw it — granting a potion in the skilltree only *permits* it. Each throw consumes one bottle. When a permitted potion has run out, the Pet skips it and reminds you to restock. This pairs naturally with [Backpack](/setup-guide/skilltree-creation/creating-custom-skilltrees/skills/backpack.md): give the Pet one and keep it stocked with the potions you want it to use.
Grant the **Materialize** upgrade (`materialize`) to remove the stock requirement — the Pet then conjures its permitted potions out of thin air, with an empty backpack (using the exact variant named in the grant). This makes a good high-level reward, mirroring the gathering skills' *No tool required*.
### Settings
| Setting | Key | Type | Meaning |
| ----------- | ------------- | ------- | ------------------------------------------------------------------------- |
| Potions | `potions` | list | The potions this level adds to the arsenal — each an entry (see below). |
| Materialize | `materialize` | boolean | When `true`, the Pet throws its permitted potions with no backpack stock. |
Each entry in `potions` has two fields:
| Field | Type | Meaning |
| ---------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `type` | potion | The permitted potion, e.g. `minecraft:healing`. Any stocked splash potion of that **effect** satisfies it (Healing I, II, …); the editor lists every potion your server knows. |
| `cooldown` | integer | Seconds between throws of **this** potion. |
The potion list in the editor is read live from your server, so any potions added by data packs or mods appear automatically — nothing is hardcoded. Grants are cumulative: a potion added at one level stays available at every level above it.
```json
"Potion": {
"Upgrades": {
"1": {
"potions": [
{ "type": "minecraft:healing", "cooldown": 6 }
]
},
"5": {
"potions": [
{ "type": "minecraft:strong_harming", "cooldown": 3 },
{ "type": "minecraft:long_strength", "cooldown": 30 }
]
},
"10": {
"materialize": true
}
}
}
```
---
# 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.mypet-plugin.com/setup-guide/skilltree-creation/creating-custom-skilltrees/skills/potion.md?ask=&goal=
```
`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.