> For the complete documentation index, see [llms.txt](https://docs.themachinesarena.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.themachinesarena.com/familiars/familiar-leveling.md).

# Familiar Leveling

This significant update allows familiars to level up, improving their effectiveness. Familiars gain experience through gameplay, with each level increasing their ability impact. For instance, ability effects will increase from 4% at Level 1 to 4.5% at Level 2, with a notable jump to 8% at Level 5. Post Level 5, familiars require specific upgrade items to continue leveling, with the initial release capping at Level 10. Future updates may expand these level caps.

**XP Sources**

Familiars gain XP through several means:

* **In-match use:** Familiars earn XP based on the match length and the player’s performance.
* **Familiar XP Books:** These items directly confer XP to a familiar.
* **Familiar Quests:** Detailed information on these will be released soon, providing additional avenues for familiar development.

Familiar leveling is a crucial aspect of The Machines Arena, allowing players to strengthen their companions and gain a competitive edge. Through consistent gameplay, XP books, and upcoming familiar quests, players can enhance their familiars' abilities and effectiveness on the battlefield. Future updates will bring even more opportunities for progression and customization, ensuring that familiars remain a vital part of your strategic arsenal.


---

# 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://docs.themachinesarena.com/familiars/familiar-leveling.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.
