> ## Documentation Index
> Fetch the complete documentation index at: https://hyperscape-ai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Playing the Game

> Character creation, controls, and gameplay basics

## Getting Started

When you first join Hyperscape, you'll create a character and spawn in a random starter town with basic equipment.

### Starting Equipment

* Bronze sword (equipped)
* Base level 1 in all skills

### Starter Towns

Each starter town includes:

* **Bank**: Store items safely
* **General Store**: Buy tools and supplies
* **Safe Zone**: No hostile mobs

## Controls

### Movement

* **Click-to-Move**: Click anywhere on the terrain to walk there
* **Running**: Hold shift while clicking to run (consumes stamina)
* **Camera**: Orthographic overhead view

### Stamina System

Stamina affects your ability to run:

* **Drain while running**: 2 stamina/second (base rate)
* **Weight penalty**: +0.5% drain per kg carried
* **Regeneration while walking**: 2 stamina/second (base rate)
* **Regeneration while idle**: 4 stamina/second (base rate)
* **Agility bonus**: +1% regeneration per agility level

<Info>
  Manage your inventory weight for optimal travel. Heavy loads drain stamina faster, but higher agility helps you recover faster.
</Info>

### Combat

* **Attack**: Click on an enemy to engage
* **Auto-attack**: Combat continues automatically while in range
* **Attack Styles**: Select focus for XP distribution (Attack, Strength, Defense)
* **Eating**: Left-click food to eat, or right-click and select "Eat" (3-tick/1.8s cooldown)
  * Food consumed even at full health (OSRS-accurate)
  * Eating during combat adds 3 ticks to attack cooldown (only if weapon already on cooldown)
  * Message format: "You eat the shrimp."

### Interaction

* **Left-click**: Execute primary action (attack, take, chop, eat, etc.)
* **Right-click**: Show context menu with all available actions
* **Shift-click**: Quick drop items from inventory
* **Objects**: Click trees, fishing spots, or resources to gather
* **NPCs**: Click to interact with shops or banks
* **Items**: Click dropped items to pick up
* **Right-Click Menus**: Right-click items/entities for context menus with colored names
* **Skill Guides**: Click any skill in the Skills Panel to view unlock progression
* **F5 Key**: Toggle FPS debug panel on/off

### Inventory Actions

* **Left-Click**: Perform primary action (Eat, Wield, Use, etc.)
* **Right-Click**: Open context menu with all available actions
* **Drag-and-Drop**: Move items between inventory slots or equip items

### Debug & UI

* **F5** or **\\**: Toggle FPS debug panel (shows frame rate, tick rate, entity count)
* **Backslash (\\)**: Alternative keybind for debug panel

## Combat Basics

Combat uses RuneScape-style mechanics:

| Stat             | Purpose                                 |
| ---------------- | --------------------------------------- |
| **Attack**       | Accuracy and weapon requirements        |
| **Strength**     | Damage dealt                            |
| **Defense**      | Damage reduction and armor requirements |
| **Constitution** | Health points                           |
| **Range**        | Ranged combat effectiveness             |

### Combat Flow

1. Click enemy to initiate combat
2. Auto-attack continues while in range
3. XP distributed based on selected attack style
4. Constitution XP always gained
5. Loot drops on enemy death

### Death

When you die:

* Items drop at death location (headstone)
* Respawn at nearest starter town
* Return to retrieve items from headstone

## Skills

### Viewing Skill Unlocks

Click any skill in the Skills panel to open the **Skill Guide Panel**, which shows:

* All unlocks for that skill with level requirements
* Your current level and progress
* Visual distinction between unlocked (✓) and locked (🔒) content
* Next unlock highlighted with progress indicator
* Type badges (item/ability) for each unlock

**Example Unlocks**:

* Attack 40: Rune weapons
* Agility 50: +50% stamina regeneration
* Prayer 43: Protect from Melee
* Woodcutting 75: Magic trees

## Skills

### Gathering Skills

| Skill           | How to Train                                          |
| --------------- | ----------------------------------------------------- |
| **Woodcutting** | Click trees with hatchet in inventory or equipped     |
| **Fishing**     | Click fishing spots with fishing rod in inventory     |
| **Mining**      | Click ore rocks with pickaxe in inventory or equipped |
| **Agility**     | Move through the world (1 XP per 2 tiles traveled)    |

<Info>
  Mining rocks always deplete after yielding one ore (OSRS-accurate). Success rate depends on your Mining level, while pickaxe tier affects how often you roll for success.
</Info>

### Agility Training

Agility is unique - it trains passively as you explore:

* **XP Rate**: 1 XP per 2 tiles traveled
* **XP Batching**: XP drops appear every 100 tiles (50 XP)
* **Running**: \~200 XP/minute
* **Walking**: \~100 XP/minute
* **Benefits**: Higher Agility = faster stamina regeneration (+1% per level)
* **Weight Impact**: Heavy inventory increases stamina drain while running (+0.5% per kg)

<Info>
  Click the Agility skill in your Skills Panel to view unlock progression and see how stamina regeneration improves with each level.
</Info>

### Processing Skills

| Skill          | How to Train                                                                      |
| -------------- | --------------------------------------------------------------------------------- |
| **Firemaking** | Use tinderbox on logs (right-click → Use)                                         |
| **Cooking**    | Use raw fish on fire (right-click → Use)                                          |
| **Smithing**   | Click furnaces to smelt ores into bars, click anvils to smith bars into equipment |

#### Smithing Details

**Smelting** (at furnaces):

* Click a furnace to open the smelting interface
* Select bar type and quantity (1, 5, 10, X, All)
* System auto-smelts until out of materials
* Bronze: 1 copper ore + 1 tin ore (100% success)
* Iron: 1 iron ore (50% success rate - OSRS accurate)
* Steel: 1 iron ore + 2 coal (100% success)
* Higher tiers require more coal (Mithril: 4, Adamant: 6, Rune: 8)
* Each smelt takes 4 ticks (2.4 seconds)

**Smithing** (at anvils):

* **Requires a hammer in inventory** (not consumed)
* Click an anvil to open the smithing interface
* Select item and quantity (1, 5, 10, X, All)
* System auto-smiths until out of bars or target reached
* Create weapons, armor, and tools
* Items greyed out if you lack level or materials
* Each smith takes 4 ticks (2.4 seconds)

## Economy

### Currency

Coins are the universal currency, dropped by mobs and used at shops.

### Banking

* Click a bank to open storage
* 480 storage slots organized in tabs
* Each bank location is separate

<Warning>
  **Combat Interruption**: Being attacked automatically closes the bank interface (OSRS-accurate). Even splash attacks (0 damage) will interrupt banking.
</Warning>

### Shops

General stores sell basic supplies:

* Hatchet (woodcutting)
* Fishing rod
* Tinderbox
* Arrows (for bows)

### Player Trading

Trade items directly with other players:

1. **Right-click** on another player
2. Select **"Trade with \[Player]"**
3. If out of range, you'll auto-walk to them
4. **Screen 1**: Add items to your offer
   * Click inventory items to add
   * Click offered items to remove
   * Enter quantities for stackable items
   * View partner's offer and free slots
   * Click **"Accept"** when ready
5. **Screen 2**: Final confirmation
   * Review wealth transfer indicator (shows value difference)
   * Both players must accept again
   * Trade completes when both confirm

**Trade Rules:**

* Must be within 2 tiles of partner
* Bank/store/dialogue closes when trade starts
* Any item change resets to Screen 1
* Moving too far apart cancels trade

## Social Features

### Friends List

Manage your friend list:

1. **Right-click** on a player
2. Select **"Add Friend"**
3. They receive a friend request
4. Once accepted, you're both friends

**Friend List Features:**

* See online/offline status (🟢 online, ⚪ offline)
* Send private messages to online friends
* Remove friends anytime
* Friend list syncs across sessions

### Private Messaging

Send direct messages to friends:

1. Open **Friends panel**
2. Click on an online friend
3. Select **"Send Message"**
4. Type and send your message

**Message Features:**

* Direct player-to-player communication
* Message history per conversation
* Notification badges for unread messages
* Integration with chat system

### Ignore List

Block unwanted interactions:

1. **Right-click** on a player
2. Select **"Add to Ignore List"**
3. Player is blocked

**Effects:**

* Their messages are hidden
* Trade requests blocked
* Friend requests blocked
* You can still see them in the world