# Companions

Companions are your fellow Yomi Gardens students, professors, or other intriguing personalities you meet while attending the conservatory. They are all digital collectibles and are the primary assets players will collect and trade. They provide bonus resource generation to your Garden and unlock interactive storylines.

<figure><img src="/files/1bUhusQg1PLUIUJXv2fH" alt=""><figcaption><p>Manami chibi sprite in-game turnaround</p></figcaption></figure>

### Companion Rarities

Each companion will have a random set of traits, which the game will designate as having rarity ranking as either **3\*, 4\*, or 5\***. 5\* companions have the strongest in-game bonuses and/or have the rarest visual traits.

3\* and 4\* companions are still excellent and useful in-game, but will provide fewer benefits overall and will be far more plentiful. Some companions will be provided for free or by playing the game, while others can only be obtained through limited-time lootboxes.

All companions will be tradable or obtainable from other players after their limited-time banners end.

**An example of potential companion traits include:**

* Bonuses to elixir prices
* Increased farming speed or yield
* Different hair or eye colors, and various aesthetic accessories
* Bonuses or resistances during weather changes

### Upgrading Companions

Players will be able to upgrade specific companions by re-rolling on specific traits using stardust. Stardust is obtained via in-game rewards or "ghosting" companion duplicates they receive from lootboxes.

As traits improve, their star-level may increase as well.

### Elemental Affinities

Each companion possesses an elemental affinity. There are a total of 5 elements:

* **Fire 🔥** -- Drive, passion, motivation
* **Earth 🏔** -- Collectiveness, stability, physicality, and gravity
* **Water 💦** -- Thoughtfulness, defensiveness, flexibility
* **Wind 🌪** -- Elusiveness, open-minded, carefree
* **Void 🌀** -- Creativity, spontaneity, inventiveness, spirit

Elemental affinities will provide additional bonuses and play a larger part in future game modes -- more to come!


---

# Agent Instructions: 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:

```
GET https://yomi-games.gitbook.io/yomi-gardens/gameplay/companions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.