# Overview

Clankermon is a Meta Trading Game built on Base, Farcaster & Clanker.

<figure><img src="https://490131370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FywqU9mRalJicdXihC6B8%2Fuploads%2FTEgjDb9FLEFiTwWGkgsE%2Fimage.png?alt=media&amp;token=66eb2a96-d349-4e94-96e2-235a61f8918d" alt=""><figcaption></figcaption></figure>

## What is a Meta Trading Game?

Clankermon is combining classic creature-collect trading game mechanics with live market dynamics to create a fun playful social gaming experience that gives players exposure to assets with potential upside, incentivizing onchain trading and education with tangible game rewards. <br>

Trading & other defi related activity have small fees, which contribute to the game rewards pool and certain activities will have other ingame benefits.

{% hint style="info" %}
eg. 1% fee on swaps, 50% of fees go to game rewards pool
{% endhint %}

Everything in the clankermon universe revolves around the native token $CLANKERMON.\
It is required for minting, reviving & will be the currency of exchange in future trading and marketplace features.\
\
Players can compete for these rewards by completing quests, battling clankermon or taking their clankermon into dungeons - each of these will carry risk, clankermon can die and revive penalities will increase on subsequent deaths, so play wisely.

{% hint style="info" %}
These mechanics are currently in development - Quests is scheduled to go live between the 17th and 24th of February, timelines for battles & dungeons are TBD
{% endhint %}

We are excited about the "Meta Trading" and live market related mechanics as they add new variables to a classic format, new tokens become new mons, legendary mons rise and fall with market cycles adding a layer of unpredictability that constantly feed into the play meta.&#x20;

While we haven't dialed in the specifics yet, ideas we are playing with involve:

* Reveal rate variance - larger market caps have smaller drop rates
* Real time buffs & Nerfs - $BANKR is pumping? Bankr mons have boosted stats

## Building in Public

Everything we are doing with clankermon is downstream of[ deploying a token with clanker on warpcast](https://warpcast.com/matthewfox/0xf1285c72). Most of our current ideas are "strong opinions loosely held" - we are building everthing in real time & building the clankermon universe chapter by chapter.

We are confident in our current approach & roadmap but remain open to new directions, have ideas? let us know in the [official clankermon channel on Warpcast.](https://warpcast.com/~/channel/clankermon)


# Mons

Mons are centric to gameplay, whether your breeding, training, battling frens or taking on dungeons - train them well and keep them alive.

## Clankermon

<figure><img src="https://490131370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FywqU9mRalJicdXihC6B8%2Fuploads%2FSsa0zEg31CfMB8HqUUwl%2Fimage.png?alt=media&amp;token=56cb27d5-c999-48f4-971d-fa925c5def82" alt=""><figcaption><p>Examples of Clankermon</p></figcaption></figure>

Clankermon are creatures inspired and tightly bound to the token they share a name with.

Above is an example, left to right:\
$CLANKFUN, $FIRE, $UNISWAP, $OPSYS, $BOLIDE

Clankermon reveal mechanic goes live in chapter 1, revealed clankermon will introduce battles & dungeons - more details soon.

## Breeding Babymons

Every mons journey starts when you mint it. All players get 1 babymon for free when they sign up, subsequent babymons currently have a mint price of 10,000 $clankermon

### Training&#x20;

* Babymons need to be trained at least once every 48 hours or they will die.
* Each train costs **1 Energy** earn your babymon **\~10 XP**&#x20;
* Players have **5 training slots** available at any given time

These are babymons levels and XP requirements:

| Mon Level | XP Required |
| --------- | ----------- |
| 0         | 0           |
| 1         | 100         |
| 2         | 400         |
| 3         | 900         |
| 4         | 1600        |
| 5         | 2500        |
| 6         | 3600        |
| 7         | 4900        |
| 8         | 6400        |
| 9         | 8100        |
| 10        | 10000       |

{% hint style="info" %}
*It takes \~1000 trains to max out one babymon*
{% endhint %}

### Reviving Babymons

When a babymon dies, there is a 48 hour window to revive them otherwise the only option is to bury them.

The current **base revival cost** is 1000 $clankermon, this doubles every time becoming more painful each time you let your little buddy die.

### Burying BabyMons

If your babymon dies and you didn't revive it within the revival window, the only option left is to bury them - Burying will burn your mon and free up a training

### Incubating Babymons \[Coming soon]

Once your babymon reaches max level, you can **"incubate"** it. This will exchange your babymon for an "Incubated Babymon"&#x20;

Incubated Babymons do not need to be trained and don't take up any of training slots.

## Revealing your babymons \[Coming Soon]

<figure><img src="https://490131370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FywqU9mRalJicdXihC6B8%2Fuploads%2FVjJzpCNhJ9kvg0Gdhvkk%2Fimage.png?alt=media&amp;token=df6cf4d7-01cf-4ac2-9b17-e0d8f48f07ad" alt=""><figcaption></figcaption></figure>


# Players

You the player are at the center of the clankermon experience, trade tokens, train your babymon & complete quest to earn

## Earning XP

XP determines your level and is the main progress metric for you as a player.

There will be multiple ways to earn XP:

* Trading Coins
* Training Babymons
* Completing quests
* Battling Clankermons
* Exploring Dungeons

{% hint style="info" %}
Right now only the only way to earn XP is trading - $1 = 1XP during chapter zero - this will be reduced significantly in later chapters as more XP earning mechanics are rolled out.
{% endhint %}

## Player Level

Your level will determine what your max energy is, the higher your max energy, the more actions you can take and longer you can take between sessions without wasting energy.

Higher levels will also get access to more features, better tiers of quests & dungeons.&#x20;

{% hint style="info" %}
Player level is capped at 10 during chapter 0, XP requirements will be rebalanced in each chapter as new mechanics change the meta.&#x20;
{% endhint %}

<table><thead><tr><th width="99">Level</th><th>XP Required</th><th>Max Energy Level</th></tr></thead><tbody><tr><td>0</td><td>0</td><td>10</td></tr><tr><td>1</td><td>100</td><td>12</td></tr><tr><td>2</td><td>250</td><td>15</td></tr><tr><td>3</td><td>500</td><td>25</td></tr><tr><td>4</td><td>1000</td><td>30</td></tr><tr><td>5</td><td>2500</td><td>35</td></tr><tr><td>6</td><td>5000</td><td>40</td></tr><tr><td>7</td><td>10000</td><td>45</td></tr><tr><td>8</td><td>25000</td><td>50</td></tr><tr><td>9</td><td>100000</td><td>55</td></tr></tbody></table>


# Quickstart

<figure><img src="https://gitbookio.github.io/onboarding-template-images/quickstart-hero.png" alt=""><figcaption></figcaption></figure>

Beautiful documentation starts with the content you create — and GitBook makes it easy to get started with any pre-existing content.

{% hint style="info" %}
Want to learn about writing content from scratch? Head to the [Basics](https://github.com/GitbookIO/onboarding-template/blob/main/getting-started/broken-reference/README.md) section to learn more.
{% endhint %}

### Import

GitBook supports importing content from many popular writing tools and formats. If your content already exists, you can upload a file or group of files to be imported.

<div data-full-width="false"><figure><img src="https://gitbookio.github.io/onboarding-template-images/quickstart-import.png" alt=""><figcaption></figcaption></figure></div>

### Sync a repository

GitBook also allows you to set up a bi-directional sync with an existing repository on GitHub or GitLab. Setting up Git Sync allows you and your team to write content in GitBook or in code, and never have to worry about your content becoming out of sync.


# Publish your docs

Once you’ve finished writing, editing, or importing your content, you can publish your work to the web as a docs site. Once published, your site will be accessible online only to your selected audience.

You can publish your site and find related settings from your docs site's homepage.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/publish-hero.png" alt=""><figcaption></figcaption></figure>


# Editor

GitBook has a powerful block-based editor that allows you to seamlessly create, update, and enhance your content.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/editor-hero.png" alt=""><figcaption></figcaption></figure>

### Writing content

GitBook offers a range of block types for you to add to your content inline — from simple text and tables, to code blocks and more. These elements will make your pages more useful to readers, and offer extra information and context.

Either start typing below, or press `/` to see a list of the blocks you can insert into your page.

### Add a new block

{% stepper %}
{% step %}

### Open the insert block menu

Press `/` on your keyboard to open the insert block menu.
{% endstep %}

{% step %}

### Search for the block you need&#x20;

Try searching for “Stepper”, for exampe, to insert the stepper block.
{% endstep %}

{% step %}

### Insert and edit your block

Click or press Enter to insert your block. From here, you’ll be able to edit it as needed.
{% endstep %}
{% endstepper %}


# Markdown

GitBook supports many different types of content, and is backed by Markdown — meaning you can copy and paste any existing Markdown files directly into the editor!

<figure><img src="https://gitbookio.github.io/onboarding-template-images/markdown-hero.png" alt=""><figcaption></figcaption></figure>

Feel free to test it out and copy the Markdown below by hovering over the code block in the upper right, and pasting into a new line underneath.

```markdown
# Heading

This is some paragraph text, with a [link](https://docs.gitbook.com) to our docs. 

## Heading 2
- Point 1
- Point 2
- Point 3
```

{% hint style="info" %}
If you have multiple files, GitBook makes it easy to import full repositories too — allowing you to keep your GitBook content in sync.
{% endhint %}


# Images & media

GitBook allows you to add images and media easily to your docs. Simply drag a file into the editor, or use the file manager in the upper right corner to upload multiple images at once.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/images-hero.png" alt=""><figcaption><p>Add alt text and captions to your images</p></figcaption></figure>

{% hint style="info" %}
You can also add images simply by copying and pasting them directly into the editor — and GitBook will automatically add it to your file manager.
{% endhint %}


# Interactive blocks

In addition to the default Markdown you can write, GitBook has a number of out-of-the-box interactive blocks you can use. You can find interactive blocks by pressing `/` from within the editor.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/interactive-hero.png" alt=""><figcaption></figcaption></figure>

### Tabs

{% tabs %}
{% tab title="First tab" %}
Each tab is like a mini page — it can contain multiple other blocks, of any type. So you can add code blocks, images, integration blocks and more to individual tabs in the same tab block.
{% endtab %}

{% tab title="Second tab" %}
Add images, embedded content, code blocks, and more.

```javascript
const handleFetchEvent = async (request, context) => {
    return new Response({message: "Hello World"});
};
```

{% endtab %}
{% endtabs %}

### Expandable sections

<details>

<summary>Click me to expand</summary>

Expandable blocks are helpful in condensing what could otherwise be a lengthy paragraph. They are also great in step-by-step guides and FAQs.

</details>

### Drawings

<img alt="" class="gitbook-drawing">

### Embedded content

{% embed url="<https://www.youtube.com/watch?v=YILlrDYzAm4>" %}

{% hint style="info" %}
GitBook supports thousands of embedded websites out-of-the-box, simply by pasting their links. Feel free to check out which ones[ are supported natively](https://iframely.com).
{% endhint %}


# OpenAPI

You can sync GitBook pages with an OpenAPI or Swagger file or a URL to include auto-generated API methods in your documentation.

### OpenAPI block

GitBook's OpenAPI block is powered by [Scalar](https://scalar.com/), so you can test your APIs directly from your docs.

{% openapi src="<https://petstore3.swagger.io/api/v3/openapi.json>" path="/pet" method="post" %}
<https://petstore3.swagger.io/api/v3/openapi.json>
{% endopenapi %}


# Integrations

GitBook integrations allow you to connect your GitBook spaces to some of your favorite platforms and services. You can install integrations into your GitBook page from the *Integrations* menu in the top left.

<figure><img src="https://gitbookio.github.io/onboarding-template-images/integrations-hero.png" alt=""><figcaption></figcaption></figure>

### Types of integrations

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>Analytics</strong></td><td>Track analytics from your docs</td><td><a href="https://www.gitbook.com/integrations#analytics">https://www.gitbook.com/integrations#analytics</a></td><td></td><td></td></tr><tr><td><strong>Support</strong></td><td>Add support widgets to your docs</td><td><a href="https://www.gitbook.com/integrations#support">https://www.gitbook.com/integrations#support</a></td><td></td><td></td></tr><tr><td><strong>Interactive</strong></td><td>Add extra functionality to your docs</td><td><a href="https://www.gitbook.com/integrations#interactive">https://www.gitbook.com/integrations#interactive</a></td><td></td><td></td></tr><tr><td><strong>Visitor Authentication</strong></td><td>Protect your docs and require sign-in</td><td><a href="https://www.gitbook.com/integrations#visitor-authentication">https://www.gitbook.com/integrations#visitor-authentication</a></td><td></td><td></td></tr></tbody></table>