> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edminions/getting-started/readme.md).

# EdMinions

Packet-based, per-player minions that grind alongside you. Minions are **only visible to their owner** — no other player ever receives a single packet for them — and everything runs off the main thread through one global async task.

## What minions do

A minion sits in a **slot** (unlock more with crates or `/minions giveslots`) and works in whatever supported plugin zone you are in:

| Plugin          | What the minion does                                                                                                                                                             |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **PinnaPrison** | Spawns in your private mine and mines blocks with you — paid exactly like your own mining (block currencies, autosell, Token Greed), standing on the packet blocks of your mine. |
| **EdTools**     | Farms your regen-zone session with you through the same pipeline as your tool (sell, block currencies, lucky blocks, enchant procs).                                             |
| **EdDungeons**  | Attacks the mob you are fighting, dealing a configurable percent of your sword damage — your boosters, enchants and rewards all apply.                                           |

Minions always grind close to their owner — targets are picked around **you** — and stand on the ground with simulated gravity (packet mobs have no server physics). Outside working zones they stand next to you (configurable).

## Highlights

* **Fully packet based & async** — zero real entities, zero main-thread work on the grind path.
* **Owner-only visibility** — your minions are yours; nobody else sees them.
* **Any look** — vanilla entities (scaled small, with a grow-in spawn animation), EdLib/BDEngine models or ModelEngine blueprints with spawn/despawn/action/idle animations.
* **Tool mirroring** — the minion holds a copy of your PinnaPrison pickaxe, EdTools omnitool or EdDungeons sword, custom model data included.
* **Upgrades** — Area, Speed and Enchant upgrades charged in a currency of the installed provider plugin (auto-detected).
* **Food** — feed minions configurable food items to keep them working (optional).
* **Everything configurable** — every text, item, GUI, animation, chance and cost.

## Quick start

1. Drop `EdMinions-x.y.z.jar` into `plugins/` (PlaceholderAPI recommended).
2. Start the server — `plugins/EdMinions/` is created with the default zombie minion.
3. `/minions give <player> zombie` — right-click the item to deposit it. It starts working immediately when you enter a supported zone.

See [Configuration](/p/edminions/features/configuration.md) to make it yours.