> For the complete documentation index, see [llms.txt](https://docs.pawtato.gg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pawtato.gg/pawtato-land/gameplay/crafting/upgrading.md). # Upgrading Tool upgrading lets Architects **increase the rarity tier of a tool** - improving its stats, efficiency, and durability. This system adds long-term progression and strategic decision-making to crafting.

Six Axe Tools from Common to Mythic Rarity Tier

#### Upgrading Path Tools must be upgraded **one rarity tier at a time**: **Common** → **Uncommon** → **Rare** → **Epic** → **Legendary** → **Mythic** You **cannot skip tiers**. #### Upgrading Cost Each upgrade attempt requires a **Crystal cost** and has a **success chance**. The higher the rarity tier, the more crystals are required - and the lower the success rate. #### Upgrading Chances and Crystal Costs

Upgrade Path	Crystal Cost	Base Success Rate
Common → Uncommon	1	60%
Uncommon → Rare	2	40%
Rare → Epic	3	25%
Epic → Legendary	5	10%
Legendary → Mythic	10	0%

There are various **optional** possibilities to **increase upgrade chances:** {% tabs %} {% tab title="Donation to the Temple of Axomamma" %} {% hint style="info" %} **Optional: Donation to the Temple of Axomamma** Architects can make a donation in **SUI** or **Divine Favor Token (DFT)\*** to increase their chance of success. \ This provides a soft monetization feature that boosts but doesn't guarantee progression. {% endhint %}

Upgrade Path	Cost	Donation Boost
Common → Uncommon	200 or 1	+30%
Uncommon → Rare	400 or 2	+25%
Rare → Epic	600 or 3	+20%
Epic → Legendary	1,000 or 5	+10%
Legendary → Mythic	2,000 or 10	+5%

{% endtab %} {% tab title="Offering of Tools" %} {% hint style="info" %} **Optional: Offering of Tools** Architects can offer up to 3 Tools of the same type as the Tool targeted to upgrade. \ Depending on rarity and quality of those offered Tools, the chance will be increased. {% endhint %}

Offered Tool Rarity	Rarity Boost	Quality Boost
Common	+1%	+0-2%
Uncommon	+2%	+0-2%
Rare	+5%	+0-2%
Epic	+10%	+0-2%
Legendary	+20%	+0-2%

{% endtab %} {% tab title="Offering of URRs" %} {% hint style="info" %} **Optional: Offering of an URR** When attempting to upgrade to Legendary or Mythic, a player can chose to offer an URR to increase the chance of the attempt. {% endhint %}

Upgrade Path	Cost	URR Boost
Epic → Legendary	1	+90%
Legendary → Mythic	1	+100%

{% endtab %} {% endtabs %} {% tabs %} {% tab title="Example Calcuation A" %} **Upgrade Attempt ****Uncommon** → **Rare** * Donation: **NO** * Offering of two **Common** Tools with 32 and 47 Quality * Offering of one **Uncommon** Tool with 5 Quality **Final Success Rate:** **45.68% (40%** + **1%** + **0.64%** + **1%** + **0.94%** + **2%** + **0.10%****)** {% endtab %} {% tab title="Example Calculation B" %} **Upgrade Attempt ****Rare** → **Epic** * Donation: **YES** * Offering of one **Rare** Tool with 69 Quality **Final Success Rate:** **51.38% (25%** + **20%** + **5%** + **1.38%****)** {% endtab %} {% endtabs %} #### Upgrade Risks * On failure, the tool remains at its current rarity * ⚠️ On failure, offered Tools, Crystals and Donations are consumed regardless! ⚠️ * The feature is **optional** - Architects can still craft higher rarity tools directly (rarely), or salvage and retry _{\*Failed Upgrades grant soul-bound} _{**Divine Favor Tokens**} _{for each Crystal used. One} _{**Divine Favor Token**} _{can be used for the Donation Boost instead of SUI.} _{**Divine Favor Tokens**} _{also have other uses in the game, mostly to boost chance-based events in the Architect's favor.}

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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.pawtato.gg/pawtato-land/gameplay/crafting/upgrading.md?ask= ``` 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.