# Quick Start

Welcome, Condemned. Get from zero to your first run fast.

<a href="https://insomnus.xyz/" class="button primary">Play Insomnus</a> <a href="https://discord.gg/QYep7k5r8w" class="button secondary">Get help on Discord</a>

{% hint style="info" %}
Want the full setup checklist and troubleshooting? Start with [Requirements](https://insomnus-1.gitbook.io/insomnus-docs/getting-started/requirements).
{% endhint %}

## 5-minute setup

{% stepper %}
{% step %}

### 1) Prepare a wallet

You need a Web3 wallet. MetaMask is the simplest option.

{% tabs %}
{% tab title="I need MetaMask" %}

1. Install [MetaMask](https://metamask.io/).
2. Create or import a wallet.
3. Back up your seed phrase offline.
   {% endtab %}

{% tab title="I already have a wallet" %}
Unlock it and make sure it supports custom networks.

WalletConnect-compatible wallets usually work too.
{% endtab %}
{% endtabs %}
{% endstep %}

{% step %}

### 2) Add the Somnia network

Use the official network details from [somnia network](https://insomnus-1.gitbook.io/insomnus-docs/web3-economy/somnia-network).

<details>

<summary><strong>Quick add (MetaMask)</strong></summary>

* **Network Name**: Somnia
* **RPC URL**: `https://rpc.somnia.network`
* **Currency Symbol**: SOMI
* **Block Explorer**: `https://browser.somnia.network`

If a field like **Chain ID** is required, use the value in the Somnia docs.

</details>
{% endstep %}

{% step %}

### 3) Open the game and connect

1. Go to <https://insomnus.xyz/>
2. Click **Connect Wallet**.
3. Approve in your wallet.
   {% endstep %}
   {% endstepper %}

{% hint style="warning" %}
Never share your seed phrase. Insomnus will never ask for it.
{% endhint %}

## First run basics

### Controls (the only ones that matter)

* **Move**: WASD / Arrow keys
* **Health Potion**: click the Health potion button
* **Armor Potion**: click the Armor potion button

<div data-with-frame="true"><figure><img src="/files/dQTPhLE179IU7QE8zV1b" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Insomnus is auto-combat.

You win with movement and positioning.
{% endhint %}

### Your first 60 seconds

{% stepper %}
{% step %}

### Spawn and scan

Stay central. Avoid corners.
{% endstep %}

{% step %}

### Pull enemies into your range

Move close enough to trigger auto-attacks.
{% endstep %}

{% step %}

### Keep a clean path

Circle-strafe. Leave an exit route.
{% endstep %}

{% step %}

### Collect XP and level up

Grab the orbs. Take an upgrade immediately.
{% endstep %}
{% endstepper %}

<details>

<summary><strong>What should I upgrade first?</strong></summary>

For your first runs:

* Damage first (fewer enemies alive = less pressure).
* Then survivability (HP/armor/dodge).
* Then utility (move speed, pickup range).

</details>

## Where to go next

<table data-view="cards"><thead><tr><th>Next step</th><th data-card-target data-type="content-ref">Open</th></tr></thead><tbody><tr><td>First run (survive longer, learn the pacing)</td><td><a href="/pages/nHP2f0e9o3xXxD8SmCAm">/pages/nHP2f0e9o3xXxD8SmCAm</a></td></tr><tr><td>Movement controls (positioning is everything)</td><td><a href="/pages/q6Nku15cOESXzvjay8cg">/pages/q6Nku15cOESXzvjay8cg</a></td></tr><tr><td>Combat system (how auto-combat actually works)</td><td><a href="/pages/Mo3FhsX4C1h05eRWzCLn">/pages/Mo3FhsX4C1h05eRWzCLn</a></td></tr><tr><td>Upgrades (build direction and scaling)</td><td><a href="/pages/4mqsnDhXzMMPzD1WbDav">/pages/4mqsnDhXzMMPzD1WbDav</a></td></tr><tr><td>Requirements (performance + troubleshooting)</td><td><a href="/pages/6CifXbaCQzBVAssRslj7">/pages/6CifXbaCQzBVAssRslj7</a></td></tr></tbody></table>

*Good luck, Condemned. See you on the leaderboard.*


---

# 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/quick-start.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.
