# Levels and Progression

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 (Reference)

**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 affects:**

* the probability of obtaining a Pep
* 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 |