> For the complete documentation index, see [llms.txt](https://studio0.gitbook.io/tome-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio0.gitbook.io/tome-docs/introduction.md).

# Introduction

Tome is a Discord bot where cards drop in your server and everyone races to grab them. Once you've got some, you can trade them, gift them, sell them, tag your favorites, and try to finish full sets for rewards.

Every command works two ways. You can type `/pull` and pick it from Discord's menu, or just type `%pull` in chat. Both do the exact same thing, so use whichever feels easier. This guide mostly writes things out with `%` since it's quicker, but `/` always works too.

Want your own command prefix instead of the server's `%`? There's a command for that on the Other Commands page.

## How a card works

Every card (like Erwin Smith from Attack on Titan) just has a name, a show it's from, and some art. Nothing's rare or common to start, every card has the same chance of showing up in a drop.

When you grab a copy of a card, that copy becomes yours and gets a few things attached to it:

| Thing                     | What it is                                                | Can it change?          |
| ------------------------- | --------------------------------------------------------- | ----------------------- |
| Stars (1 to 5 ★)          | How good a roll you got when you claimed it               | No, it's set forever    |
| Mint number (like `#123`) | Basically "you were the Nth person to ever own this card" | No                      |
| Card code                 | A short code just for that one copy, like `n7FQHj`        | No                      |
| Card ID                   | The number next to it in your own collection list         | Yes, it can move around |

A misprint copy counts its mint number separately, so you'll see `MP#123` instead of `#123` for those. More on all this on Collection & Card IDs.

## Currencies

Four currencies float around, each earned differently. Full breakdown on Currencies & Daily Rewards.

| Currency | How you get it                                                | What it's for                                      |
| -------- | ------------------------------------------------------------- | -------------------------------------------------- |
| Gold     | Daily claim, finishing a series, selling cards, melting dupes | Shop stuff, frames, buying things off other people |
| Tickets  | Daily quests, finishing a whole series                        | A guaranteed pull, and part of the frame shop      |
| Ink      | Voting for the bot                                            | Upgrading a card's stars                           |
| Gems     | Finishing a whole series                                      | The final push on a max star upgrade               |

## Your first pull

1. Type `/pull` or `%pull`. A couple random cards drop in the channel, each with its own button.
2. Click a button before someone else does and that card's yours.
3. Didn't click in time? After 90 seconds it's just gone. It won't get forced onto whoever pulled it.
4. After you pull or claim, you'll need to wait 10 minutes before doing that again.

Want every little detail on odds, guaranteed pulls, and special art? Check out Pulling & Claiming.

## Where to go next

**Pulling and looking things up**

* Pulling & Claiming: pulling, claiming, star odds, guaranteed high rolls, special art
* Card Lookup: looking up a card or a whole show
* Cooldowns & Reminders: checking your timers, getting DMed when they're up

**Your collection**

* Collection & Card IDs: viewing and searching your cards
* Tags & Auto-tagging: labeling cards with emoji
* Wishlist: keeping track of what you want
* Trading & Gifting: swapping or giving cards to people

**Money stuff**

* Currencies & Daily Rewards: the four currencies, your daily claim, quests, and Tome+
* Shop & Perks: buying little boosts
* Frames: dressing up your cards
* Leaderboards & Series Rewards: rankings and finishing a set

**Buying and selling**

* Marketplace: Listings: selling for a set price
* Auctions: letting people bid
* Card Valuation: how the bot guesses what a card's worth

**Everything else**

* Other Commands: your own prefix, invite links


---

# 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://studio0.gitbook.io/tome-docs/introduction.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.