> 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/gathering.md).
# Gathering
Let your Pet gather resources — mining ore, felling trees, and fishing.
**Mining**, **Lumberjack**, and **Fishing** are three related skills that let a Pet gather resources on its own while it is out with you. They share the same rhythm: every few seconds the Pet looks for something to work on nearby, walks over to it, and plays the matching animation before producing the drop.
* **Mining** — breaks the nearest *exposed* ore block (any face touching air) and drops its natural result, exactly as if you had mined it. Once it starts on a vein it clears the whole connected cluster before looking elsewhere.
* **Lumberjack** — fells the nearest tree from the bottom up. By default it takes **one log per work cycle**; the **Logs per cycle** upgrade lets it fell more of the trunk at once. Free-standing log pillars without leaves are left alone.
* **Fishing** — casts at nearby open water and, a moment later, drops vanilla fishing loot beside the Pet. No water is ever removed.
The Pet only works while it is spawned, its owner is online, and the owner is within **16 blocks**. It also commits to **one chore at a time** — you will see it walk to the ore or tree and break it before moving on to the next task, rather than doing everything at once. Once Lumberjack starts on a tree it stays on that tree until the whole trunk is down, and Mining likewise clears the entire connected ore vein it digs into before moving on (unless you walk away and it follows you).
Each of these skills can be switched on or off per pet from the **pet menu** (`/pet`) — handy for pausing the auto-gathering without changing the skilltree.
### Tools
By default each skill needs a real tool in the Pet's [Backpack](/setup-guide/skilltree-creation/creating-custom-skilltrees/skills/backpack.md):
| Skill | Required tool |
| ---------- | ------------- |
| Mining | a pickaxe |
| Lumberjack | an axe |
| Fishing | a fishing rod |
The tool has to actually be able to harvest the target — a wooden pickaxe will **not** mine diamond ore, for example. The Pet uses the real tool from its backpack, so its **enchantments apply** (Fortune and Silk Touch change the drops) and it **loses durability** with each use, breaking and disappearing when it is worn out. When the Pet has no usable tool it simply does nothing and reminds the owner to restock.
Because tools and drops both live in the backpack, these skills pair naturally with [Backpack](/setup-guide/skilltree-creation/creating-custom-skilltrees/skills/backpack.md) and [Pickup](/setup-guide/skilltree-creation/creating-custom-skilltrees/skills/pickup.md): give the Pet all three and it will hold its own tools and collect everything it gathers.
Grant the **No tool required** upgrade (`toolless`) to remove the tool requirement entirely — the Pet then works bare-pawed with no durability cost. This makes a good high-level reward on a gathering skilltree.
### Settings
Each of the three skills is configured the same way through the [skilltree](/setup-guide/skilltree-creation/what-are-skilltrees.md) skill settings:
| Setting | Key | Type | Meaning |
| ---------------- | ---------- | ------- | --------------------------------------------------------------------------- |
| Range | `range` | number | How far (in blocks) the Pet searches for work. Capped at 8 blocks. |
| Interval | `interval` | integer | Seconds between attempts. Both Range and Interval must be above 0. |
| No tool required | `toolless` | boolean | When `true`, the Pet works without a tool (no durability). Default `false`. |
**Lumberjack** has one extra setting:
| Setting | Key | Type | Meaning |
| -------------- | ------ | ------- | ------------------------------------------------------------------------ |
| Logs per cycle | `logs` | integer | Trunk logs felled each cycle. Base is 1; add to it to fell more at once. |
Example skilltree entry that grants Mining at level 1 (tool required) and removes the tool requirement at level 5:
```json
"Mining": {
"Upgrades": {
"1": { "Range": "+6", "Interval": "+2" },
"5": { "toolless": true }
}
}
```
Lumberjack and Fishing use the exact same keys.
### Disabling globally
Each skill has a server-wide kill-switch in [`config.yml`](/setup-guide/getting-started/configuration/config.yml.md) — `MyPet.Skill.Mining.Active`, `MyPet.Skill.Lumberjack.Active`, and `MyPet.Skill.Fishing.Active` (all `true` by default). Setting one to `false` leaves the skill visible in skilltrees but stops it from doing any work.
---
# 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/gathering.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.