> 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/frames.md). # Frames Frames are a decoration around a card's art. They've got nothing to do with how many stars a card rolled, a 1 star card and a 6 star card can wear the exact same frame. What they do affect is a little bit of value, and, unlike most cosmetics, they're something you put on one specific card at a time rather than a look that follows your whole collection around. | Command | What it does | | -------------------------------- | ---------------------------------------------------------------------------------------- | | `%frameshop` | Browse every frame, what it costs, and what you already own | | `%buyframe ` | Buy a frame | | `%equip \| ` | Put an owned frame on one or more of your cards. Leave the frame off to take it back off | ## Frames go on a card, not on you This is the part that trips people up coming from other bots: buying a frame doesn't make it show up on everything you own. It just goes into your collection of frames you're allowed to use. You still have to run `%equip` and tell it which specific card you want it on. That also means a card only looks better because you deliberately decorated it, and it's the one card that got a small value bump, not your whole collection at once, see Card Valuation. `%equip` takes more than one card at a time too. `%equip 275, 274, 265-260 | Aurora` puts Aurora on all five in one go. Leave the frame off entirely, `%equip 275` by itself, and it takes whatever's currently on that card back off, no need to own the frame to do that part. This works on misprints too, put any frame you own on a misprint the same as you would any other card. ## What happens when a framed card gets traded The frame stays on the card, not with you. If you trade or gift away a card you've framed, whoever receives it keeps seeing that frame on it, it's part of that specific print now. What they can't do is peel it off and put it on one of their own other cards, since they never actually bought that frame themselves. They can still remove it from the card they received if they don't want it there, they just can't move it anywhere else. ## A huge and growing catalog Tome's frame collection has grown past 100 and keeps growing, so this page tracks broad strokes rather than every single one by name and price - `%frameshop` is always the accurate, up to the minute source for the full list, what everything actually costs, and what you already own. Roughly how pricing breaks down: | Tier | Price range | Currency | What's in it | | -------- | -------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Everyday | 10-60 | Tickets | Simple, clean designs - the ones you'll own early and often | | Premium | 6,000-55,000 | Gold | Elaborate, legendary-tier designs | | Seasonal | usually 20,000 | Gold | Holiday-themed frames, only purchasable while their event is actually running (Halloween, Christmas, Valentine's, and so on) - see `%frameshop` for which ones are live right now | A handful of the corner-icon frames (Puppylove, Kittywhisk, Foxtrail, Pandabamboo, Berrybox, Citrusfizz, Vineyard, Kiwipop) use real open licensed artwork instead of a drawn pattern, everything else is original. A small number of frames are drawn with extra decoration that spills past the card's own edge in the `%frameshop` preview, gachapon style, though on a real card it settles in flush with the edges instead. ## Spotting a framed card in your collection `%collection` shows a little status emoji for each card, right after its tags. If a card is framed, that's the exact frame's own emoji, so you can tell which frame is on which card without opening each one. That same slot also covers a plain card (🎴), a poster (🖼️), a misprint (🎨), or a compensation grant (🎁), whichever one actually applies, see Collection & Card IDs. Holiday event art always uses its own special frame no matter what's equipped on it - that one comes with the art itself, and there's no swapping it out. Misprints don't have this restriction: a misprint shows whatever frame you've equipped on it (or the plain default border if you haven't equipped anything), exactly like any other card. --- # 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/frames.md?ask=&goal= ``` `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.