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

# Relics

> Powerful NFTs with unique in-game abilities

## What are Relics?

Relics are **ERC721 NFT tokens** that provide powerful special abilities during gameplay. Each relic has a unique effect that can dramatically change the outcome of your game.

## Acquiring Relics

Relics can be obtained by:

1. **Minting** - Use CHIP tokens to mint new relics from the Relic NFT contract
2. **Trading** - Buy/sell relics on NFT marketplaces (they're standard ERC721)
3. **Rewards** - Special events may distribute relics as prizes

## Using Relics in Game

### Equipping

* You can **equip one relic per session**
* Once equipped, a relic **cannot be changed** during that session
* Equipping does NOT activate the relic - it just makes it available

### Activating

* Click on your equipped relic to **activate its ability**
* The effect is **queued** and applies on your **next spin**
* After activation, a **cooldown** begins (measured in spins)

<Note>
  Relic effects don't happen immediately - they trigger when you perform your next spin!
</Note>

## The Five Genesis Relics

### 1. Mortis

<Columns cols={2}>
  <div>
    <img src="https://mintcdn.com/abyss-a11da403/1Lv09-kXXcla6jkk/images/relics/mortis.png?fit=max&auto=format&n=1Lv09-kXXcla6jkk&q=85&s=05f590a75c67b50435721946c3ba7b71" alt="Mortis" width="120" data-path="images/relics/mortis.png" />
  </div>

  <div>
    **Force Random Jackpot**

    Your next spin forces a random jackpot pattern (all 15 symbols become the same).

    **Cooldown:** 10 spins

    **Strategy:** Use when you need a big score boost. The jackpot symbol is random.
  </div>
</Columns>

***

### 2. Phantom

<Columns cols={2}>
  <div>
    <img src="https://mintcdn.com/abyss-a11da403/1Lv09-kXXcla6jkk/images/relics/phantom.png?fit=max&auto=format&n=1Lv09-kXXcla6jkk&q=85&s=4ce3557a9cbbf9f4aa3f738f80833074" alt="Phantom" width="120" data-path="images/relics/phantom.png" />
  </div>

  <div>
    **Double Next Spin**

    Your next spin's score is **doubled**.

    **Cooldown:** 5 spins

    **Strategy:** Best used after setting up score bonuses with items.
  </div>
</Columns>

***

### 3. Lucky the Dealer

<Columns cols={2}>
  <div>
    <img src="https://mintcdn.com/abyss-a11da403/1Lv09-kXXcla6jkk/images/relics/lucky_the_dealer.png?fit=max&auto=format&n=1Lv09-kXXcla6jkk&q=85&s=317bb5a21c3c95297080d7433194f8f3" alt="Lucky the Dealer" width="120" data-path="images/relics/lucky_the_dealer.png" />
  </div>

  <div>
    **Trigger 666** ⚠️

    Forces a 666 result on next spin - **ends your game!**

    **Cooldown:** 8 spins

    **Strategy:** Use only if you have La Biblia item to survive.
  </div>
</Columns>

***

### 4. Scorcher

<Columns cols={2}>
  <div>
    <img src="https://mintcdn.com/abyss-a11da403/1Lv09-kXXcla6jkk/images/relics/scorcher.png?fit=max&auto=format&n=1Lv09-kXXcla6jkk&q=85&s=0b86119de5c82239b224941405a912b1" alt="Scorcher" width="120" data-path="images/relics/scorcher.png" />
  </div>

  <div>
    **Reset Spins**

    Resets your spins remaining to **5**.

    **Cooldown:** 7 spins

    **Strategy:** Use when you're about to run out of spins but haven't reached threshold.
  </div>
</Columns>

***

### 5. Inferno

<Columns cols={2}>
  <div>
    <img src="https://mintcdn.com/abyss-a11da403/1Lv09-kXXcla6jkk/images/relics/inferno.png?fit=max&auto=format&n=1Lv09-kXXcla6jkk&q=85&s=979695718d188d310197564154f65a32" alt="Inferno" width="120" data-path="images/relics/inferno.png" />
  </div>

  <div>
    **Free Market Refresh**

    Refresh the market items **for free** (normally costs points).

    **Cooldown:** 6 spins

    **Strategy:** Use when the market has bad items.
  </div>
</Columns>

## Relic Technical Details

### Contract Information

* **Standard:** ERC721 (fully tradeable)
* **Contract:** `Relic NFT Contract` on Starknet
* **Metadata:** On-chain (name, description, effect type, cooldown)

### On-Chain Metadata

Each relic stores:

```cairo theme={null}
struct RelicMetadata {
    relic_id: u8,           // Unique relic type ID (1-5)
    name: felt252,          // "Mortis", "Phantom", etc.
    description: felt252,   // Effect description
    effect_type: u8,        // Effect ID for game logic
    cooldown_spins: u32,    // Cooldown in spins
    image_uri: felt252,     // IPFS URI for image
}
```

### Integration Flow

```mermaid theme={null}
sequenceDiagram
    participant Player
    participant GameContract
    participant RelicNFT
    
    Player->>GameContract: equip_relic(session_id, token_id)
    GameContract->>RelicNFT: owner_of(token_id)
    RelicNFT-->>GameContract: player_address
    GameContract->>GameContract: Store equipped_relic
    
    Player->>GameContract: activate_relic(session_id)
    GameContract->>RelicNFT: get_relic_metadata(token_id)
    RelicNFT-->>GameContract: metadata
    GameContract->>GameContract: Queue pending_effect
    GameContract->>GameContract: Set cooldown
```