> For the complete documentation index, see [llms.txt](https://liquidx.gitbook.io/pixelpals-documentation-season-0/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://liquidx.gitbook.io/pixelpals-documentation-season-0/duel-coming-soon.md).

# Duel (COMING SOON)

Duel is the main PvP game module where you can engage in battles with other PixelPals. Duels are essentially a 5 round turn-based card game, where you have the option to check, fold, or double your wager based on the outcome of each round. 

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

### PixelCards

PixelCards form the basis of the Duel game, and there are three types of cards in cirulcation:

* Attack cards - lowers enemy HP
* Defense cards - counters enemy attack cards
* Special ability cards - triggers special events&#x20;

All cards are attributed with a specific rarity from the following tiers:&#x20;

* Common
* Uncommon
* Rare
* Super Rare

There is an initial supply of 24 variations of PixelCards, with more to be added.&#x20;

PixelCards also exist in two forms within the game:&#x20;

* Non-NFT&#x20;
* NFT (ERC-1155)&#x20;

NFT cards can be obtained via opening card packs from the shop & can be burnt to upgrade the rarity tiers and be traded on secondary markets. NFT cards are distinguished from the normal cards with a shining effect applied on the front.&#x20;

<figure><img src="/files/28TgAVvRDNXQkEDNIMYG" alt=""><figcaption></figcaption></figure>

### Collection & Deck

All users will start with a standard set of 10 cards in their deck. Every user must have a configured deck of 10 cards at any point in time while obeying the following rules:&#x20;

* Minimum 4 attack cards
* Minimum 4 defense cards
* Free to choose 2 cards&#x20;

If you have more than 10 cards in possession, the excess gets moved into the collection. You are able to customize your deck by swapping cards between your collection and your deck. &#x20;

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

### Burn to Earn

When you have an excess number of cards, you have the option to burn 5 NFT cards of the same tier to receive a 25% chance of obtaining 1 NFT card from the next rarity tier.&#x20;

Note that the burning of cards mean that the NFTs are burnt regardless of the outcome.&#x20;

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


---

# 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, and the optional `goal` query parameter:

```
GET https://liquidx.gitbook.io/pixelpals-documentation-season-0/duel-coming-soon.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.