> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abyssgame.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# Soul Charms

> Collect Soul Charms to boost your Luck and unlock powerful effects in Abyss

## What are Soul Charms?

**Soul Charms (\$CHARM)** are a new NFT collection in Abyss that give you a permanent advantage in your games. Unlike temporary items, Charms are owned by you and can be brought into any session.

Primary benefits:

* **Boost Luck**: Increases the chance of symbols forming patterns via VRF bias.
* **Passive Effects**: Special bonuses like extra spins, pattern multipliers, or conditional luck.
* **Collectibility**: 20 unique charms across 4 rarity tiers (Common, Rare, Epic, Legendary).

## How Luck Works

Luck is a special stat provided by Charms that biases the **VRF randomness** in your favor.

* **Normal Spin**: Each symbol is completely random (independent).
* **With Luck**: The grid generation is biased to "copy" neighbors, making patterns more likely to form.
* **Higher Luck = Better Patterns**: The more Luck you have, the higher the probability of connecting huge horizontal, vertical, or diagonal lines.

## How to Obtain

1. **Minting**: At the end of every competitive game, you have a chance to mint a random Charm based on your score.
   * Chance = `min(Score / 125, 50)%`
2. **Shop**: Charms you own can appear in the in-game Market, allowing you to "equip" their effects for that session by buying them with points.

## Supply & Rarity

There is a **fixed total supply of 10,000 Charms**.

| Rarity        |  Types | Supply Each | Total Supply |   Shop Cost  |
| :------------ | :----: | :---------: | :----------: | :----------: |
| **Common**    |    8   |     800     |     6,400    |  50-100 pts  |
| **Rare**      |    6   |     400     |     2,400    |  150-300 pts |
| **Epic**      |    4   |     200     |      800     |  400-600 pts |
| **Legendary** |    2   |     200     |      400     | 800-1200 pts |
| **Total**     | **20** |      -      |  **10,000**  |       -      |

***

## Charm Collection

### Common Charms

*Basic luck boosters and utility effects.*

<Columns cols={3}>
  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/whisper_stone.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=75c561d2100814413f6ee21bcb95c501" alt="Whisper Stone" width="1024" height="1024" data-path="images/charms/whisper_stone.png" />

    **Whisper Stone**
    +3 Luck
    *Cost: 50 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/faded_coin.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=dabfa07b6feae5761f23d39db4fc6fc4" alt="Faded Coin" width="1024" height="1024" data-path="images/charms/faded_coin.png" />

    **Faded Coin**
    +4 Luck
    *Cost: 65 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/broken_mirror.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=fdcaa0718ec1ad0adbaca938215ea5ed" alt="Broken Mirror" width="1024" height="1024" data-path="images/charms/broken_mirror.png" />

    **Broken Mirror**
    +5 Luck if last spin had no patterns
    *Cost: 70 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/dusty_hourglass.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=629584b760f8a262d6a8455e3dfeedaf" alt="Dusty Hourglass" width="1024" height="1024" data-path="images/charms/dusty_hourglass.png" />

    **Dusty Hourglass**
    +4 Luck if ≤2 spins remaining
    *Cost: 75 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/cracked_skull.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=949fcac0d1bddd443822c75b10115859" alt="Cracked Skull" width="1024" height="1024" data-path="images/charms/cracked_skull.png" />

    **Cracked Skull**
    +5 Luck
    *Cost: 80 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/rusty_key.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=b4c5aa6eb455a5bf04dadac03b36cd8e" alt="Rusty Key" width="1024" height="1024" data-path="images/charms/rusty_key.png" />

    **Rusty Key**
    +3 Luck per item in inventory
    *Cost: 85 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/moth_wing.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=553cbb12fa94715dd0bd7342ce3e4eb9" alt="Moth Wing" width="1024" height="1024" data-path="images/charms/moth_wing.png" />

    **Moth Wing**
    +6 Luck
    *Cost: 90 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/bone_dice.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=93af5e1cc9db13900e857a0a757636f4" alt="Bone Dice" width="1024" height="1024" data-path="images/charms/bone_dice.png" />

    **Bone Dice**
    +8 Luck if score \< 100
    *Cost: 100 pts*
  </Card>
</Columns>

### Rare Charms

*Stronger effects and pattern bonuses.*

<Columns cols={3}>
  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/soul_fragment.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=193e4639031373f0e794a32938d853d8" alt="Soul Fragment" width="1024" height="1024" data-path="images/charms/soul_fragment.png" />

    **Soul Fragment**
    +10 Luck
    *Cost: 150 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/cursed_pendant.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=c75f60861c0f4e32ca9ea40cbe73885c" alt="Cursed Pendant" width="1024" height="1024" data-path="images/charms/cursed_pendant.png" />

    **Cursed Pendant**
    Horizontal-3 patterns trigger **twice**
    *Cost: 200 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/shadow_lantern.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=582727dfdfb42232e3ca267b930a9f15" alt="Shadow Lantern" width="1024" height="1024" data-path="images/charms/shadow_lantern.png" />

    **Shadow Lantern**
    +8 Luck (+4 more if Level ≥ 5)
    *Cost: 220 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/ethereal_chain.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=b11b73a4443dfb0edc61d86336333159" alt="Ethereal Chain" width="1024" height="1024" data-path="images/charms/ethereal_chain.png" />

    **Ethereal Chain**
    +6 Luck per pattern in last spin
    *Cost: 250 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/void_compass.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=6ded38564c634e477f59e39c46ff82e1" alt="Void Compass" width="1024" height="1024" data-path="images/charms/void_compass.png" />

    **Void Compass**
    +1 Spin with +15 Luck boost
    *Cost: 280 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/demons_tooth.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=64a92b544e78beda139b678540cd1ad6" alt="Demon's Tooth" width="1024" height="1024" data-path="images/charms/demons_tooth.png" />

    **Demon's Tooth**
    Diagonal patterns trigger **twice**
    *Cost: 300 pts*
  </Card>
</Columns>

### Epic Charms

*Powerful game-altering abilities.*

<Columns cols={3}>
  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/abyssal_eye.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=1cd0bfe5c0c7ccd0a6ffb04b15cdf4bd" alt="Abyssal Eye" width="1024" height="1024" data-path="images/charms/abyssal_eye.png" />

    **Abyssal Eye**
    +20 Luck
    *Cost: 400 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/phoenix_feather.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=1c94272a95ced2c8c390764b7b44b328" alt="Phoenix Feather" width="1024" height="1024" data-path="images/charms/phoenix_feather.png" />

    **Phoenix Feather**
    +2 Spins with +10 Luck each
    *Cost: 500 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/reapers_mark.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=9f0423f32f903d03512d18b8cc23ca30" alt="Reaper's Mark" width="1024" height="1024" data-path="images/charms/reapers_mark.png" />

    **Reaper's Mark**
    **ALL** patterns trigger twice
    *Cost: 550 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/chaos_orb.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=1698256e46b28624a85f404ceb28e4e9" alt="Chaos Orb" width="1024" height="1024" data-path="images/charms/chaos_orb.png" />

    **Chaos Orb**
    +15 Luck if 666 was blocked this session
    *Cost: 600 pts*
  </Card>
</Columns>

### Legendary Charms

*The ultimate artifacts of the Abyss. Extremely rare.*

<Columns cols={2}>
  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/soul_of_abyss.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=b14ced5e98326367a7acc6345543bbf8" alt="Soul of the Abyss" width="1024" height="1024" data-path="images/charms/soul_of_abyss.png" />

    **Soul of the Abyss**
    +30 Luck. Jackpots trigger **twice**.
    *Cost: 1000 pts*
  </Card>

  <Card>
    <img src="https://mintcdn.com/abyss-a11da403/f6lUMOL8xvRhwmjw/images/charms/void_heart.png?fit=max&auto=format&n=f6lUMOL8xvRhwmjw&q=85&s=38af423b0a10d38694aff520cab05adf" alt="Void Heart" width="1024" height="1024" data-path="images/charms/void_heart.png" />

    **Void Heart**
    +25 Luck. +1 Spin (+50 Luck). All patterns 1.5x.
    *Cost: 1200 pts*
  </Card>
</Columns>