> 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/saddlebags.md).

# Saddlebags

A vanilla llama is capped at **15 storage slots** (a strength-5 llama; most wild ones are weaker). Caravans lifts that cap with **saddlebags** — multiple **15-slot pages** per pack-llama — without leaving the vanilla llama screen.

## How it works

* The **active page is the llama's real native inventory** — the normal screen you open by right-clicking it. It looks and behaves exactly like vanilla.
* The other pages are stashed on the llama itself. **Flipping** swaps the page you're looking at out to the stash and the next one in.
* Pages are a **full 15-slot grid** and unlock once a llama reaches **strength 5**. By default there are **6 pages = 90 slots** per maxed llama (configurable).

{% hint style="info" %}
There's no custom menu and no resource pack — every page is the genuine vanilla llama inventory. The extra capacity rides along on the llama and is saved with it.
{% endhint %}

## Earning the slots

A pack-llama **keeps the strength it naturally rolled** when you give it a chest — Caravans doesn't force it. From there it slowly earns its way up to **strength 5** (the full 15-slot grid, where saddlebag pages unlock) as its owner **plays**:

* A lucky **natural 5** is already maxed — full slots from day one.
* A weaker roll **earns the rest** over time, +3 slots each strength level.

It's all computed quietly in the background from your playtime — there's no bar to watch and no extra load on the server; a llama just catches up the moment you open or Khipu-tap it. A small puff and a chime mark a freshly-opened column. While it's still growing, the Khipu shows `strength x/5 · N slots`. The pace is `progression.minutes-per-level` (default 60; `0` turns leveling off).

{% hint style="info" %}
**Donkeys and mules** can join the caravan too, but they stay plain vanilla — their native 15-slot chest, no saddlebag pages and no leveling. Llamas are the upgradeable pack animal.
{% endhint %}

## Working the saddlebags — the Khipu

| Gesture                         | What it does                                                          |
| ------------------------------- | --------------------------------------------------------------------- |
| **Right-click a llama**         | Read its load — `page x/N · items here · total`                       |
| **Sneak + right-click a llama** | Flip to the next page (the visible page swaps out, the next swaps in) |

To browse: sneak-tap to flip to the page you want, then right-click the llama with an empty hand to open it as usual.

## With the rest of the caravan

* **Recruiting or Khipu-tapping** a llama catches its strength up to what you've earned so far (see [Earning the slots](#earning-the-slots)) before the screen opens — so it's always the right size.
* A **storage run** carries a courier's **whole** load — every page, not just the one on screen — so nothing is left behind when it slips away to deposit.

## Tuning

| Key                             | Default | What it does                                                                             |
| ------------------------------- | ------- | ---------------------------------------------------------------------------------------- |
| `storage.pages`                 | `6`     | 15-slot pages per maxed llama (6 × 15 = 90 slots). Set `1` for vanilla — no extra pages. |
| `progression.minutes-per-level` | `60`    | Minutes of playtime to earn one strength level (+3 slots). `0` turns leveling off.       |

Apply changes live with `/caravan reload`.

***

*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/saddlebags.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.