> For the complete documentation index, see [llms.txt](https://critters-quest-1.gitbook.io/critters-quest-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://critters-quest-1.gitbook.io/critters-quest-docs/critter-quest-guides.md).

# Critter Quest Guides

## Table of Contents

* [Getting Started](#getting-started)
* [Core Game Mechanics](#core-game-mechanics)
* [Resource System](#resource-system)
* [Tools & Equipment](#tools--equipment)
* [Crafting System](#crafting-system)
* [Item Identification System](#item-identification-system)
* [Town Building System](#town-building-system)
* [Advanced Features](#advanced-features)
* [Technical Information](#technical-information)
* [Getting Started Checklist](#getting-started-checklist)

## Getting Started

### Welcome to Critters Quest

Critters Quest is a blockchain-based resource gathering and town-building game where players deploy NFT critters to gather resources, craft tools, and build thriving towns. The game combines strategic resource management with competitive elements like looting and leaderboards.

### First Steps(Beta)

* **Create Account**: Connect using email through Privy authentication system
* **Wallet Creation**: A wallet will be automatically generated for you upon email verification
* **Acquire Critter**: Get your first critter NFT (beta allocation process)
* **Initial Resources**: Each critter starts with a different amount of locked $QUEST tokens
* **Town Placement**: Place your town strategically on the map
* **First Deployment**: Deploy your first critter to gather basic resources

### Basic Controls

* **Desktop**: WASD to move, Shift to run faster
* **Mobile**: Use joystick (customizable position in settings)
* **Camera**: Mouse/touch to pan and zoom
* **Interaction**: Click on buildings, resources, and UI elements

## Core Game Mechanics

### Quest Token Economy - CRITICAL UNDERSTANDING

**Two Types of Quest Tokens:**

#### 1. Locked Quest (On Critter)

* **Used for**: Critter actions (gathering, moving, leveling Critter up)
* **Location**: Stored individually on each critter NFT
* **Cannot be transferred** only spent
* **Used for**: All critter-specific activities

#### 2. Town Bank Quest

* **Used for**: Town upgrades, building construction, crafting
* **Location**: Stored in your town's bank building
* **Can be**: Deposited/withdrawn
* **Required for**: All town development

**Payment Rules:**

* **Critter actions** = Locked Quest from that specific critter
* **Town/crafting actions** = Town Bank Quest

### Resource System

#### Resource Node Mechanics

* **Health Points**: Each resource has specific HP (720K to 99M+)
* **Level Gating**: Town level determines which resource tiers you can see
  * Level 1 Town = Can see Tier 1 resources
  * Level 2 Town = Can see Tier 1-2 resources
  * Level 3 Town = Can see Tier 1-3 resources
* **Node Movement**: Resource nodes periodically move to new locations across the map
* **Finite Uses**: Each node has limited gathering attempts
* **Competition**: Multiple players can gather from same node

#### Tool Requirements & Level Scaling

* **Tier 1 Tools**: Access to basic resource yields
* **Tier 3+ Tools**: Advanced feature unlocked - **Resource Level Control**
  * Set difficulty level on any resource node
  * Higher levels = increased yield + longer time
  * Choose optimal risk/reward ratio

## Resource System

### Forest Resources (Axe)

<table><thead><tr><th width="100" data-type="image"></th><th>Resource</th><th>Town Level</th><th>HP</th><th>Key Drops</th></tr></thead><tbody><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FSLaxijU5ZqlMUOrarIXb%2FSapling.png?alt=media&#x26;token=cd64f26a-a0e9-4921-ae75-584664a62e87">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FSLaxijU5ZqlMUOrarIXb%2FSapling.png?alt=media&#x26;token=cd64f26a-a0e9-4921-ae75-584664a62e87</a></td><td>Sapling</td><td>1</td><td>720K</td><td>Wood, Unknown Recipe</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FvV0Ii89m4glyem9vCIfH%2FBirch.png?alt=media&#x26;token=398a4876-4775-485a-aeeb-275e7e9e5891">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FvV0Ii89m4glyem9vCIfH%2FBirch.png?alt=media&#x26;token=398a4876-4775-485a-aeeb-275e7e9e5891</a></td><td>Birch</td><td>2</td><td>1.7M</td><td>Wood, Tree Sap</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2Favx8tCmArAi2qNiZLpco%2FPine.png?alt=media&#x26;token=6b3c1520-556c-4ee5-ab9b-db29e5262cc6">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2Favx8tCmArAi2qNiZLpco%2FPine.png?alt=media&#x26;token=6b3c1520-556c-4ee5-ab9b-db29e5262cc6</a></td><td>Pine</td><td>3</td><td>3M</td><td>Coal, Tree Sap,</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2Fbt6a6UD79dsdhnzttaWn%2FOak.png?alt=media&#x26;token=9c37b97a-0cc4-4321-b454-042024b934aa">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2Fbt6a6UD79dsdhnzttaWn%2FOak.png?alt=media&#x26;token=9c37b97a-0cc4-4321-b454-042024b934aa</a></td><td>Oak</td><td>3</td><td>5.8M</td><td>Magical Spores</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FHsMZfQKmwDLD5nyImsnw%2FMaple.png?alt=media&#x26;token=83339024-79fc-4698-a9e7-c881843733e4">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FHsMZfQKmwDLD5nyImsnw%2FMaple.png?alt=media&#x26;token=83339024-79fc-4698-a9e7-c881843733e4</a></td><td>Maple</td><td>4</td><td>8.3M</td><td>Wood Tree Sap</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FhNAHNKf1Iga43LhY0p8j%2FIronwood.png?alt=media&#x26;token=a84dccb9-fcf8-4e6c-935d-dccfff8ffbf0">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FhNAHNKf1Iga43LhY0p8j%2FIronwood.png?alt=media&#x26;token=a84dccb9-fcf8-4e6c-935d-dccfff8ffbf0</a></td><td>Ironwood</td><td>4</td><td>13.1M</td><td>Wood, Iron Ore</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2F9Y8vH6vUAQsAsqfWFAcF%2FAncient%20Oak.png?alt=media&#x26;token=77b66e7c-0635-408d-b4d6-b4075e80dfcf">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2F9Y8vH6vUAQsAsqfWFAcF%2FAncient%20Oak.png?alt=media&#x26;token=77b66e7c-0635-408d-b4d6-b4075e80dfcf</a></td><td>Ancient Oak</td><td>6</td><td>29.1M</td><td>Wood, Ancient Wood</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2F6afj0GH3AQL8jb6E3cBo%2FShimmerwood.png?alt=media&#x26;token=3ef96395-93a0-4fed-bd7d-cf56eee1592d">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2F6afj0GH3AQL8jb6E3cBo%2FShimmerwood.png?alt=media&#x26;token=3ef96395-93a0-4fed-bd7d-cf56eee1592d</a></td><td>Shimmerwood</td><td>8</td><td>38.8M</td><td>Ancient Wood, Diamonds</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FlMkqD7GlOzM3m8PToZdA%2FElderwood.png?alt=media&#x26;token=8819636f-90ab-499d-a04e-4c3cac47471c">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FlMkqD7GlOzM3m8PToZdA%2FElderwood.png?alt=media&#x26;token=8819636f-90ab-499d-a04e-4c3cac47471c</a></td><td>Elderwood</td><td>8</td><td>59.4M</td><td>Ancient Wood , Recipes</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FD1rRuvhXz7ZDWKQSpYwE%2FCrystal%20Pine.png?alt=media&#x26;token=f237de5d-ebde-4964-8ef2-bc0e88230303">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FD1rRuvhXz7ZDWKQSpYwE%2FCrystal%20Pine.png?alt=media&#x26;token=f237de5d-ebde-4964-8ef2-bc0e88230303</a></td><td>Crystal Pine</td><td>9</td><td>71.2M</td><td>Ancient Wood, Gems</td></tr></tbody></table>

### Mining Resources(PickAxe)

<table><thead><tr><th width="100" data-type="image"></th><th>Resource</th><th>Town Level</th><th>HP</th><th>Key Drops</th></tr></thead><tbody><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2F99NMCHx2637Oxsm3f5WM%2FBasic%20Rock.png?alt=media&#x26;token=4656145e-d813-41f7-ad25-b26a02ed685b">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2F99NMCHx2637Oxsm3f5WM%2FBasic%20Rock.png?alt=media&#x26;token=4656145e-d813-41f7-ad25-b26a02ed685b</a></td><td>Basic Rock</td><td>1</td><td>720K</td><td>Stone</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FnIwelyzgWa0wzWGpNWld%2FCommon%20Deposit.png?alt=media&#x26;token=48a0d0d5-1216-4de0-9317-1fcfec2c739c">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FnIwelyzgWa0wzWGpNWld%2FCommon%20Deposit.png?alt=media&#x26;token=48a0d0d5-1216-4de0-9317-1fcfec2c739c</a></td><td>Common Deposit</td><td>2</td><td>1.7M</td><td>Coal, Iron Ore</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FOAjm9IbJiu44y0lafAmr%2FMineral%20Outcrop.png?alt=media&#x26;token=1dc8862f-357b-4dc7-ad95-eb6af17355bd">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FOAjm9IbJiu44y0lafAmr%2FMineral%20Outcrop.png?alt=media&#x26;token=1dc8862f-357b-4dc7-ad95-eb6af17355bd</a></td><td>Mineral Outcrop</td><td>3</td><td>4M</td><td>Iron Ore, Steel Ingots</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FdDG713iIN3vEUuX5BwKv%2FRich%20Vein.png?alt=media&#x26;token=6dc7a1bc-6b73-407f-ac6f-15825b0d71e1">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FdDG713iIN3vEUuX5BwKv%2FRich%20Vein.png?alt=media&#x26;token=6dc7a1bc-6b73-407f-ac6f-15825b0d71e1</a></td><td>Rich Vein</td><td>4</td><td>7.8M</td><td>Iron Ore, Copper Ore</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FLDoI4IvWXoVNz3d6tym5%2FRare%20Formation.png?alt=media&#x26;token=a1b9456a-b72d-4ae4-b25d-e47ae79ac4e7">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FLDoI4IvWXoVNz3d6tym5%2FRare%20Formation.png?alt=media&#x26;token=a1b9456a-b72d-4ae4-b25d-e47ae79ac4e7</a></td><td>Rare Formation</td><td>4</td><td>11.3M</td><td>Copper Ore, Iron Ore</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FCiISVfxfzXfN4RAlb15o%2FPrecious%20Deposit.png?alt=media&#x26;token=a07fc450-6044-47e4-9a9f-50b73c3ceafd">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FCiISVfxfzXfN4RAlb15o%2FPrecious%20Deposit.png?alt=media&#x26;token=a07fc450-6044-47e4-9a9f-50b73c3ceafd</a></td><td>Precious Deposit</td><td>5</td><td>15.1M</td><td>Gold Ore, Gold Dust</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FBUcjIqmv5o2tKwYTz0Zx%2FExceptional%20Cluster.png?alt=media&#x26;token=2d0c86b4-4c9e-4ccf-aca0-0bba1fe86340">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FBUcjIqmv5o2tKwYTz0Zx%2FExceptional%20Cluster.png?alt=media&#x26;token=2d0c86b4-4c9e-4ccf-aca0-0bba1fe86340</a></td><td>Exceptional Cluster</td><td>6</td><td>29.1M</td><td>Gold Ore, Diamonds</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FtntbAsBbGUU5iBSBm3Iu%2FPristine%20Geode.png?alt=media&#x26;token=6cec07f4-8b84-4e8c-847b-2f22ad848dee">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FtntbAsBbGUU5iBSBm3Iu%2FPristine%20Geode.png?alt=media&#x26;token=6cec07f4-8b84-4e8c-847b-2f22ad848dee</a></td><td>Pristine Geode</td><td>7</td><td>38.8M</td><td>Emeralds, Ruby, Recipes</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2Fwc6rFYx2wAQNtuSMXHaO%2FAncient%20Formation.png?alt=media&#x26;token=1c5d0615-0540-4a04-b6da-1875953d03b9">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2Fwc6rFYx2wAQNtuSMXHaO%2FAncient%20Formation.png?alt=media&#x26;token=1c5d0615-0540-4a04-b6da-1875953d03b9</a></td><td>Ancient Formation</td><td>8</td><td>59.4M</td><td>Crystal Fragments, Ancient Relics, sapphires</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FmNFnLD13LdAjsE2IZmGs%2FLegendary%20Remnant.png?alt=media&#x26;token=6abc8888-816a-4989-91ec-127344e84776">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FmNFnLD13LdAjsE2IZmGs%2FLegendary%20Remnant.png?alt=media&#x26;token=6abc8888-816a-4989-91ec-127344e84776</a></td><td>Legendary Remnant</td><td>9</td><td>66M</td><td>Tech Fragments, Amethyst, Emeralds</td></tr></tbody></table>

### Digging Resources(Shovel)

<table><thead><tr><th width="100" data-type="image"></th><th>Resource</th><th>Town Level</th><th>HP</th><th>Key Drops</th></tr></thead><tbody><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FZli4XaOQfBmpkVTXRVpL%2FLoose%20Soil.png?alt=media&#x26;token=da2a4b08-5965-46b8-8260-a4cbb558fb62">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FZli4XaOQfBmpkVTXRVpL%2FLoose%20Soil.png?alt=media&#x26;token=da2a4b08-5965-46b8-8260-a4cbb558fb62</a></td><td>Loose Soil</td><td>1</td><td>1.7M</td><td>Clay, Recipes</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FKQHdadvAqNOJ3AmrxQTd%2FHerb%20Patch.png?alt=media&#x26;token=f9e5b072-3945-4623-ab62-29a2beb74b74">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FKQHdadvAqNOJ3AmrxQTd%2FHerb%20Patch.png?alt=media&#x26;token=f9e5b072-3945-4623-ab62-29a2beb74b74</a></td><td>Herb Patch</td><td>2</td><td>3M</td><td>Clay, herbs</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FeFeSBp5Q4eWSzfHe1Tro%2FSeep.png?alt=media&#x26;token=e5ac79c5-18d6-4c78-882a-a72942778648">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FeFeSBp5Q4eWSzfHe1Tro%2FSeep.png?alt=media&#x26;token=e5ac79c5-18d6-4c78-882a-a72942778648</a></td><td>Seep</td><td>4</td><td>7.5M</td><td>Water, sand</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FgOxJYDxKFhAsvKG6XFpM%2FMushroom%20Circle.png?alt=media&#x26;token=2eb31639-c969-40e3-a8f4-57d1cf64255f">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FgOxJYDxKFhAsvKG6XFpM%2FMushroom%20Circle.png?alt=media&#x26;token=2eb31639-c969-40e3-a8f4-57d1cf64255f</a></td><td>Mushroom Circle</td><td>8</td><td>19.4M</td><td>Mushroom, Magical Spore</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FeuLhRthpCvSO25DXugoB%2FAncient%20Grove.png?alt=media&#x26;token=bd0988ae-4375-4beb-96c0-c18e3def4e43">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FeuLhRthpCvSO25DXugoB%2FAncient%20Grove.png?alt=media&#x26;token=bd0988ae-4375-4beb-96c0-c18e3def4e43</a></td><td>Ancient Grove</td><td>10+</td><td>71.28M</td><td>Ancient Relics, Tech Fragments, Light Essence</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FRVBFxjBvAoC2fmkZCuhX%2FGravel.png?alt=media&#x26;token=7bc73c78-7b97-4f37-9262-781ecc32dbb1">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FRVBFxjBvAoC2fmkZCuhX%2FGravel.png?alt=media&#x26;token=7bc73c78-7b97-4f37-9262-781ecc32dbb1</a></td><td>Gravel</td><td>1</td><td>1.5M</td><td>Stone, Coal</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FuGVAFKhQ839sAL6FWo6y%2Fmineral_depost.png?alt=media&#x26;token=1665de66-2861-41c0-bf76-4e216db72170">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FuGVAFKhQ839sAL6FWo6y%2Fmineral_depost.png?alt=media&#x26;token=1665de66-2861-41c0-bf76-4e216db72170</a></td><td>Mineral Deposit</td><td>3</td><td>5.8M</td><td>Copper Ore, Coal</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2Fy2QaSRdQdp0FMnQwV9Ss%2FBone%20Pile.png?alt=media&#x26;token=544c69b7-c8ff-47b1-97a9-d3423081a69e">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2Fy2QaSRdQdp0FMnQwV9Ss%2FBone%20Pile.png?alt=media&#x26;token=544c69b7-c8ff-47b1-97a9-d3423081a69e</a></td><td>Bone Pile</td><td>4</td><td>8.5M</td><td>Bone, Diamond Fragments</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FWiNMuwagAT4tCT5YtaVb%2FCrystal%20Soil.png?alt=media&#x26;token=b1a503ea-7075-4f93-ad58-6026e719f4d4">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FWiNMuwagAT4tCT5YtaVb%2FCrystal%20Soil.png?alt=media&#x26;token=b1a503ea-7075-4f93-ad58-6026e719f4d4</a></td><td>Crystal Soil</td><td>8</td><td>19.4M</td><td>Crystal Fragments, Gems</td></tr><tr><td><a href="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FZAlUEUwU4oS7UmI5re2W%2FAncient%20Cache.png?alt=media&#x26;token=592fbe9e-f0d6-49ca-b661-dbff8a1bfb51">https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FZAlUEUwU4oS7UmI5re2W%2FAncient%20Cache.png?alt=media&#x26;token=592fbe9e-f0d6-49ca-b661-dbff8a1bfb51</a></td><td>Ancient Cache</td><td>10</td><td>71.2M</td><td>Ancient Relics, Gems</td></tr></tbody></table>

### Reward System

<figure><img src="https://3264544466-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fr73ayamnhU5HB8BAPhOH%2Fuploads%2FPmyxJ9dbi4Bxc7zj5Fxt%2Fimage.png?alt=media&#x26;token=db40d012-1b81-45e3-9da9-8c5ba0fc3f6c" alt=""><figcaption></figcaption></figure>

* **Guaranteed Rewards (Yellow Border)**: 100% participation reward
* **Common Drops (Grey Border)**: 100% chance for basic materials
* **Uncommon Drops (Green Border)**: 50% chance for upgraded materials
* **Rare Drops (Light Blue Border)**: 5% chance for premium materials
* **Bonus Items (Pink/Red Border)**: 1% chance for special tools/recipes<br>

### First Completion Bonus

The first player to complete a resource node unlocks additional potential rewards for themselves. All other players receive only guaranteed participation rewards.

## Tools & Equipment

### Tool Tier System

<table><thead><tr><th>Tier</th><th>Tool Type</th><th width="157">Damage Range</th><th>Luck Range</th><th>Durability Range</th><th>Sockets</th></tr></thead><tbody><tr><td>1</td><td>Wood Tool</td><td>20-40</td><td>0%</td><td>172,800-259,200</td><td>0</td></tr><tr><td>3</td><td>Stone Tool</td><td>60-100</td><td>2.5-5%</td><td>345,600-518,400</td><td>0-1</td></tr><tr><td>5</td><td>Steel Tool</td><td>120-180</td><td>5-10%</td><td>604,800-777,600</td><td>0-1</td></tr><tr><td>7</td><td>Diamond Tool</td><td>200-300</td><td>7.5-15%</td><td>2,592,000-3,456,000</td><td>0-2</td></tr><tr><td>9</td><td>Emerald Tool</td><td>325-475</td><td>10-20%</td><td>5,184,000-6,912,000</td><td>1-2</td></tr><tr><td>11</td><td>Advanced Tools</td><td>500-700</td><td>12.5-25%</td><td>1,173,690-1,509,030</td><td>1-3</td></tr></tbody></table>

### Advanced Tool Features (Tier 3+)

* **Resource Level Control**: Set difficulty level on resource nodes
* **Yield Multiplier**: Higher levels increase resource yield
* **Time Trade-off**: Higher levels require longer gathering time
* **Socket System**: Higher tier tools have sockets for upgrades

## Crafting System

### The Muddy Anvil (Blacksmith)

#### Pickaxe Crafting (Mining Tools)

**Wood Pickaxe (Tier 1)**

* Materials: 2 Wood
* Cost: 10 $QUEST (Town Bank)
* Crafting Time: 1 hour
* Durability: 172,800-259,200
* Repair Cost: 1 $QUEST per 25,000 durability

**Stone Pickaxe (Tier 3)**

* Materials: 1 Stone, 1 Coal
* Cost: 110 $QUEST (Town Bank)
* Crafting Time: 3 hours
* Durability: 345,600-518,400

**Steel Pickaxe (Tier 5)**

* Materials: 1 Coal, 1 Steel Ingot
* Cost: 375 $QUEST (Town Bank)
* Crafting Time: 8 hours
* Durability: 604,800-777,600

**Diamond Pickaxe (Tier 7)**

* Materials: 1 Wood, 1 Stone, 1 Coal, 1 Clay, 1 Refined Sap, 1 Polished Diamond, 1 Steel Ingot, 1 Gold Solution, 1 Copper Ingot
* Cost: 1,350 $QUEST (Town Bank)
* Crafting Time: 24 hours
* Durability: 2,592,000-3,456,000

**Emerald Pickaxe (Tier 9)**

* Materials: 1 Wood, 1 Stone, 1 Coal, 1 Clay, 1 Refined Sap, 1 Polished Emerald, 1 Polished Diamond, 1 Gold Ingot, 1 Copper Ingot
* Cost: 2,400 $QUEST (Town Bank)
* Crafting Time: 48 hours
* Durability: 5,184,000-6,912,000

#### Axe Crafting (Tree Chopping)

Same tiers, optimized for wood gathering. Axes cost slightly more than pickaxes at each tier: Wood 10, Stone 150, Steel 500, Diamond 1,800, Emerald 3,200 $QUEST.

#### Shovel Crafting (Digging)

Same tiers, optimized for soil. Shovels are the priciest of the three: Wood 10, Stone 190, Steel 625, Diamond 2,250, Emerald 4,000 $QUEST.

#### Smelting Operations

* **Copper Smelting**: 1 Coal + 1 Copper Ore = 1 Copper Ingot (Processing: 2h, Cost: 5 $QUEST)
* **Iron Smelting**: 1 Coal + 1 Iron Ore = 1 Iron Ingot (Processing: 3h, Cost: 5 $QUEST)
* **Steel Forging**: 1 Iron Ingot + 1 Copper Ingot = 1 Steel Ingot (Processing: 4h, Cost: 15 $QUEST)
* **Gold Smelting**: 1 Gold Ore + 1 Copper Ingot = 1 Gold Ingot (Processing: 6h, Cost: 20 $QUEST)

## Item Identification System

### The Mystic Mirror (Oracle)

#### Identification Process

Unknown items and recipes can be identified through a tiered system that determines what quality recipes you can discover.

| Level | Time | Cost ($QUEST) | Recipe Tiers Available |
| ----- | ---- | ------------- | ---------------------- |
| 1     | 4h   | 2             | T1 only                |
| 2     | 4h   | 3             | T1-T2 weighted         |
| 3     | 4h   | 4             | T1-T3 weighted         |
| 4     | 4h   | 7             | T1-T4 weighted         |
| 5     | 3h   | 10            | T1-T5 weighted         |
| 6     | 3h   | 15            | T1-T6 weighted         |
| 7     | 3h   | 23            | T1-T7 weighted         |
| 8     | 2h   | 33            | T1-T8 weighted         |
| 9     | 2h   | 50            | T1-T9 weighted         |
| 10    | 1h   | 75            | T1-T10 weighted        |

Each level also consumes raw materials that scale from 2 Wood at level 1 up to a mix of Wood, Clay, Tree Sap, Stone, and ores at higher levels. All costs are paid from Town Bank Quest.

## Town Building System

### Core Buildings

**The Muddy Anvil (Blacksmith)**

* Purpose: Tool crafting, weapon creation, metal working
* Functions: Pickaxe/Axe/Shovel crafting, smelting operations
* Upgrade Levels: 1-10+ with increasing capabilities

**The Building Barrel**

* Purpose: Construction materials, building upgrades
* Functions: Advanced building component creation

**The Glistening Nexus (Jeweler)**

* Purpose: Gem cutting, jewelry creation, enchantments
* Functions: Processing rare materials into valuable items

**The Glowing COG (Ancient Tech Lab)**

* Purpose: Advanced technology, ancient relic processing
* Functions: Tech fragment utilization, energy cell creation

**The Mystic Mirror (Oracle - Item Identification)**

* Purpose: Unknown item identification, recipe discovery
* Functions: Converting unknown recipes into usable knowledge

**The Bank (Resource Protection/Management)**

* Purpose: Secure resource storage, town fund management
* Functions: Quest token banking, resource protection

**The WALL (City Wall)**

* Purpose: Town defense, expansion control
* Functions: Protection systems, territory control

### Building Upgrade Requirements

Each building has multiple upgrade levels requiring increasing amounts of materials and Quest tokens from your Town Bank. Higher levels unlock better recipes, faster processing times, and additional functionality.

## Advanced Features

### Looting System

* **Sleep Timer**: Critters become lootable 24 hours after completing gathering without claiming rewards
* **Visual Indicators**: Sleeping critters show golden shimmer effect
* **Instant Looting**: No travel time required - click to loot immediately
* **Availability**: Must have idle critter in town to perform looting
* **Competition**: First player to loot claims the rewards

### Competitive Elements

* **Mining Leaderboards**: Track top performers on each resource
* **First Completion Bonuses**: Extra rewards for first player to finish a node
* **Resource Competition**: Multiple players can gather from same nodes
* **Loot Racing**: Competition to claim sleeping critters

## Technical Information

### Blockchain Integration

* Built on Solana blockchain
* Critters are NFTs with individual locked Quest balances
* Town creation costs: \~0.05-0.06 SOL + token account creation fees
* All transactions require on-chain confirmation

### Performance Optimization

* **Known Issues**: M3/M4 Mac heating problems
* **Browser**: Chrome recommended with balanced performance settings
* **Mobile**: iPhone heating reported, Safari vs Chrome testing recommended
* **Refresh**: Many UI issues resolve with page refresh

### Troubleshooting

* **Error Messages**: Often indicate tool requirements not met or insufficient resources
* **Disappearing UI**: Usually resolved by refreshing page

## Getting Started Checklist

1. **Connect Email Wallet & Acquire Critter**
2. **Place Your Town** (location matters for initial resources)
3. **Deploy First Critter** to nearest Tier 1 resource
4. **Claim First Rewards**
5. **Build Mystic Mirror** (identify unknown recipes)
6. **Build Muddy Anvil** (craft better tools)
7. **Upgrade Town Level** (access higher tier resources)
8. **Craft Tier 3+ Tools** (unlock level scaling feature)
9. **Expand & Optimize** your resource gathering strategy

**Remember**: Critter actions use Locked Quest, Town development uses Town Bank Quest!