# ! Levels and Progression

#### Levels and Progression show how your Typer grows over time in Peptype.

The Typer upgrades are the core progression feature that helps your Typer grow over time. By upgrading, you unlock new benefits, improve efficiency, and gain access to higher-level mechanics. Each upgrade increases a Typer level by +1 and takes a fixed amount of time.

***

**When you upgrade a Typer:**

* the upgrade takes time to complete
* the Typer gains +1 level after completion
* the upgrade costs energy + tokens
* after upgrade daily energy limit is refreshed

***

#### Parallel Upgrades

**Rules:**

* upgrades are tracked per Typer
* Typer cannot start a second upgrade while it is already upgrading
* different Typer can upgrade in parallel, each with its own timer and costs

You can upgrade multiple Typer at the same time if they own more than one Typer.

***

#### Milestone Bonus: +1 Energy

**When Typer reaches these levels, it gains +1 maximum energy:**

* Level 5
* Level 10
* Level 20
* Level 30

This bonus is applied automatically when the upgrade completes and the milestone level is reached.

***

#### Level Cost Table

**Upgrade time:** 

Level 1 - 2: 10 minutes

> **For all other upgrades:** upgrade\_time\_minutes = 20 \* (current\_level - 1)

| **Level range** | **Cost**         |
| --------------- | ---------------- |
| 1–5             | 1 energy + token |
| 6–10            | 2 energy + token |
| 11–20           | 3 energy + token |
| 21–30           | 4 energy + token |

***

#### Rarity 

Each Typer is assigned a rarity tier at generation. Rarity shows how special a Typer or item is compared to others.

A lower rarity means the character or item is more common. A higher rarity means it is harder to get, more valuable, and more desirable for players, collectors, and traders.

\
**Rarity affects:**

* the probability of obtaining a Typer
* the efficiency of energy generation through typing activity
* starting advantages

Higher rarity Typer require fewer interactions to generate energy.

***

#### **Rarity Table**

| **Rarity** | **Energy Generation**                                   |
| ---------- | ------------------------------------------------------- |
| Common     | 10,000 typing actions per 1 energy                      |
| Uncommon   | 9,000 typing actions per 1 energy                       |
| Rare       | 8,000 typing actions per 1 energy                       |
| Epic       | 7,000 typing actions per 1 energy                       |
| Legendary  | 5,000 typing actions per 1 energy + 1 additional energy |

***


---

# 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://peptype.gitbook.io/peptype/features/levels-and-progression.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.