> For the complete documentation index, see [llms.txt](https://docs.perplay.io/perplay-whitepaper/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perplay.io/perplay-whitepaper/game-fi/workshop/gem-upgrade.md).

# Gem Upgrade

<figure><img src="/files/XEacTM70QFFoQsAVfjHi" alt=""><figcaption></figcaption></figure>

Upgrading a Gem is the act of spending three identical Gems to gain a Gem of one level higher. The three Material Gems must be identical in color, effect, and level.

You need XPER and PER for a Gem Upgrade.

The result of a Gem Upgrade will be either a success or a failure.

<table><thead><tr><th width="157">Result</th><th>Description</th></tr></thead><tbody><tr><td>Sucess</td><td>The three Material Gems are spent and you gain a Gem that is one level higher than the Materials.</td></tr><tr><td>Failure</td><td>The three Material Gems are spent.</td></tr></tbody></table>

The probability of success is determined by the following:

* Level of Material Gems
* Whether the Upgrade Booster item was used