> For the complete documentation index, see [llms.txt](https://machina-1.gitbook.io/machina-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://machina-1.gitbook.io/machina-docs/llamas/readme.md).

# Caravans

**Give your pack-llamas real purpose.** Caravans turns tamed chest-llamas into a working caravan — one that follows you in a tidy line, carries far more than a vanilla llama, runs your overflow back to storage while you keep exploring, and stands guard over a spot.

It's built on a **custom movement system** that replaces Minecraft's native pathfinder: vanilla AI goals are stripped and each llama is driven by a verified arrival-steering loop, so caravans flow instead of snagging and stop-starting. And it's all controlled **in-world** — two crafted tools, no command list to memorize.

{% hint style="info" %}
New here? Start with [**Getting started**](/machina-docs/llamas/getting-started.md) to craft the two tools and form your first caravan.
{% endhint %}

## Features

* **Caravan follow** — your chest-llamas trail you in an evenly-spaced line. An elastic-band follow keeps them close without conga pile-ups, rubberbands them to catch up when you sprint, and quietly teleports a straggler only when it's truly out of reach.
* **Llamas, donkeys & mules** — all three march. Llamas are the upgradeable pack animal; **donkeys and mules** ride along as plain vanilla 15-slot haulers.
* **Saddlebags** — a vanilla llama caps at 15 slots; Caravans gives each pack-llama several **15-slot pages** (90 by default). The active page is the **real native llama screen**, so storage stays fully vanilla — there are just more of them. A llama keeps its natural strength roll and **earns its way to the full grid as you play**.
* **Storage runs** — when your packs fill up, send half the caravan off: they walk out of sight, deposit cargo into the depots you've recorded, and wander back, empty. A *diegetic* courier run — no teleport menu. A full caravan can even **dispatch its own run** automatically.
* **Lead camel & quartermaster** — appoint a camel and the caravan follows **it** instead of you (ride it, or park it as a camp). As you play, that camel grows into a **quartermaster** that speeds your storage runs.
* **Guardians & protectors** — set a llama to guard a spot (it spits — damage + Slowness + knockback), or appoint a tamed **wolf** to actively protect the moving caravan.
* **Smooth & believable** — they swim with their heads clear, route around lava and cliffs, climb small steps, and trace around obstacles instead of circling.
* **Two tools, no commands** — the **Drover's Stick** herds the caravan and appoints camels and wolves; the **Khipu** works the saddlebags, keeps your depots, and dispatches runs. Built from plain vanilla items, so ordinary sticks and leads stay vanilla.

## Compatibility

* **Minecraft 1.20.x → 26.x** · Paper / Purpur (one jar across the range)
* **Server-side only** — nothing for players to install.

***

*Caravans is built by* [***Machina***](https://wearemachina.com) *— custom Minecraft plugins and more at* [*wearemachina.com*](https://wearemachina.com)*.*


---

# 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://machina-1.gitbook.io/machina-docs/llamas/readme.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.