> 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/pulling-and-claiming.md).

# Pulling & Claiming

`/pull` and `%pull` do the exact same thing (`%p`, `%gacha`, `%roll`, and `%spawn` all work too).

| Command | What it does                                               |
| ------- | ---------------------------------------------------------- |
| `%pull` | Drops a few random cards for anyone in the channel to grab |

## How many cards drop

Normally 2 or 3. Bought the Extra Card perk? Up to 2 more per pull. Bought Feast too? One more on top of that. Stack everything and a single pull can go as high as 6 cards, see Shop & Perks for both.

That number's really more like a budget than a card count though. A normal card uses up 1 slot, but a poster (the big full art ones) takes up 2. So a poster can only show up if there's enough room left in the pull for it. If there isn't, you might just get fewer cards than the max, not something smaller squeezed in to fill the gap. Posters have their own independent 5% chance to show up on any slot with room for one.

Each card that drops is picked completely on its own, so getting one character doesn't make them more or less likely to show up again in the same drop.

Pulling doesn't cost you anything, it's just on a 10 minute timer. Bought the Extra Drop perk? Your next pull skips the wait completely.

If there's nothing in the card pool yet, `%pull` will just let you know instead of dropping something broken.

## Claiming

Every card that drops gets its own button. Whoever clicks first gets it, simple as that. Once someone claims a card, the button locks with their name on it so everyone can see who got what.

Claiming has its own separate 10 minute timer from pulling. You can claim cards from someone else's drop even if your own pull is still on cooldown. An Extra Grab charge skips your next claim wait.

If nobody clicks a card within 90 seconds, it's gone for good. It never gets forced onto whoever pulled it, so a drop nobody wanted doesn't quietly end up in their collection anyway.

## Star odds and pity

Every card you claim on a normal pull rolls its own star quality, 1 through 5:

| Stars | Odds |
| ----- | ---- |
| ★     | 40%  |
| ★★    | 30%  |
| ★★★   | 18%  |
| ★★★★  | 9%   |
| ★★★★★ | 3%   |

The bot keeps count of your bad luck behind the scenes. Every time you claim something under 4 stars, that count goes up by one. Land a 4 star or higher and it resets back to zero. Once that count hits 50, your very next claim is guaranteed to be a 4 or 5 star. Check how close you are with `%cooldowns`, see Cooldowns & Reminders.

Already got a card you like at a lower star count? `%upgrade` spends Ink (and Gems for the last step) to raise it up to 5 stars over time. See Currencies & Daily Rewards.

## Ascended cards (A1 through A5)

Ascended is a tier above 5 stars, shown as A1 through A5 instead of a star count, the rarest cards in the game. Nothing above raises a card into it: a normal pull, pity, `%upgrade`, and compensation all stop hard at 5 stars, on purpose.

There are exactly two ways in:

* **`%ascend`**: fuse spare copies of a card you already own at the current top tier into the one you're raising. Costs more copies for the first step into Ascended (3 copies of a 5-star to reach A1) and fewer for each step after that. See Collection & Card IDs.
* **A rare bonus chance on `%tickets pull`**: see below. About 1 in 2,000 guaranteed pulls hits Ascended instead of its usual 4-5 star floor, heavily weighted toward A1 over anything higher.

An Ascended card is worth dramatically more than a 5-star. A1 alone is 20x a 5-star's value, since reaching it at all means fusing 3 identical 5-star dupes of the exact same card, the hardest single wall in the whole game. It only climbs further from there, though each step after A1 gets cheaper in dupes needed, so the value climbs more gently once you're in. See Card Valuation.

## Misprints

Every claim has a small 1% shot at landing a misprint instead of the normal art. Misprints are special recolored versions someone made by hand, so this can only happen on cards that actually have one. If a card doesn't, that roll just quietly does nothing and you get normal art like usual.

Misprints count their mint numbers separately, so you'll see `MP#123` instead of a regular `#123`. They're always marked with a 🎨 so you know what you got.

## Posters

Big full art versions of a card. They take up 2 pull slots instead of 1 (see above), but otherwise work just like any other card: same star odds, same misprint chance, same mint counting.

## Holiday art

Some art only shows up around its matching holiday, and is completely out of the pool the rest of the year:

| Holiday     | When you'll see it   |
| ----------- | -------------------- |
| Christmas   | December             |
| Halloween   | October              |
| Valentine's | February             |
| Easter      | March and April      |
| Spring      | March through May    |
| Summer      | June through August  |
| New Year    | December and January |
| Anniversary | All year round       |

This goes for misprints too. A Valentine's misprint won't show up outside of Valentine's season either.

## Getting pinged for your wishlist

If a card that drops is on someone's wishlist, they get pinged right in the drop message so they don't miss it. This only happens if 5 or fewer people combined want that stuff, otherwise nobody gets pinged so it doesn't spam the whole server. And whoever pulled the drop never gets pinged for their own pull, even for something on their own wishlist.

## Tickets pull

`%tickets pull` (or the shortcut `%tp`) spends 25 Tickets for a pull that's always guaranteed at least a 4 or 5 star, but only once you've got something on your wishlist, since that's what it actually pulls from. Add something first with `wishlist add <card>` or `wishlist addseries <series>`.

It's a completely separate system from pity above and doesn't touch that counter either way.

Most of the time it hands you a card straight off your wishlist, but there's also a small independent chance it hands you a random poster or a random misprint instead, and, rarer still, that same rare shot at an Ascended card mentioned above. Full details on Collection & Card IDs.


---

# 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/pulling-and-claiming.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.
