# Upgrades

Level up and create powerful character builds.

***

## Upgrade System

### Level-Up Upgrades

Every level-up presents 3 random upgrade options from the following categories:

{% tabs %}
{% tab title="Offensive Upgrades" %}

* Damage Boost (+10% damage)
* Attack Speed (+15% speed)
* Crit Chance (+5% crit)
* Multi-Shot (Additional projectile)
* Pierce (+1 enemy penetration)
  {% endtab %}

{% tab title="Defensive Upgrades" %}

* Max HP (+20 HP)
* Armor (+5 armor)
* Dodge Chance (+8% evasion)
* Thorns (Reflect damage)
  {% endtab %}

{% tab title="Utility Upgrades" %}

* Move Speed (+10% speed)
* Pickup Range (+50% range)
* Dash Cooldown (-15% cooldown)
* XP Gain (+15% XP)
  {% endtab %}
  {% endtabs %}

### Upgrade Stacking

* Most upgrades can stack multiple times
* Diminishing returns apply after 5 stacks
* Synergies exist between certain upgrade combinations

***

## Resource Collection

### Experience (XP)

* Dropped by defeated enemies
* Fill the XP bar to level up
* Each level grants: **+1 Upgrade Choice**

### Points

* Premium currency earned through gameplay
* Currently tracked but not yet spendable
* Will be used when progression system launches

***

## Build Archetypes

| Archetype        | Core Upgrades              | Playstyle                  |
| ---------------- | -------------------------- | -------------------------- |
| **Glass Cannon** | Damage, Attack Speed, Crit | Aggressive, high risk      |
| **Tank**         | HP, Armor, Thorns          | Defensive, outlast enemies |
| **Speed Demon**  | Move Speed, Dash Cooldown  | Hit-and-run tactics        |
| **XP Farmer**    | XP Gain, Pickup Range      | Level up faster            |

### Synergy Examples

| Build              | Synergy                                  |
| ------------------ | ---------------------------------------- |
| **Pierce Build**   | Pierce + Multi-Shot + Damage             |
| **Crit Build**     | Crit Chance + Crit Damage + Attack Speed |
| **Survivor Build** | Max HP + Armor + Dodge + Pickup Range    |

***

## Upgrade Pool

| Category  | Number of Upgrades |
| --------- | ------------------ |
| Offensive | 20+                |
| Defensive | 15+                |
| Utility   | 15+                |
| **Total** | **50+**            |

***

*Choose wisely. Adapt or die.*


---

# 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://docs.insomnus.xyz/core-gameplay/upgrades.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.
