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

# Playing the Game

> Character creation, controls, and gameplay basics

## System Requirements

<Warning>
  **WebGPU Required**: Hyperscape requires WebGPU for rendering. WebGL is NOT supported.
</Warning>

**Supported Browsers**:

* Chrome 113+ (recommended)
* Edge 113+
* Safari 18+ (macOS 15+ only)

**Check Compatibility**: Visit [webgpureport.org](https://webgpureport.org) to verify your browser/GPU supports WebGPU.

**Why WebGPU?**: All shaders use TSL (Three Shading Language), which only works with WebGPU. There is no WebGL fallback.

## 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

### 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
* **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

### 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 |

<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>

### 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)