Craft

Images

Pictures make a world feel real: a portrait for each character, a scene for each place, an icon for each item, and a cover for the world itself. In Craft a picture is never a bare link. A file stores an image object, which holds the picture's address and what Craft knows about it: where to crop it, whether a generation is still running, and the other faces a character can show. This doc covers how pictures get onto files, how to keep a whole world in one style, and what happens to pictures during play.

How it is used

  • Every file can have a main picture, its image. A file type can declare more image fields of its own, such as a token or a banner. A file type can also have a default picture, shown for its files that have none.
  • Pictures come from four places: uploaded by a person, generated by a person in the app, generated by an agent (Orbit or a coding agent in a workspace), or made by the GM during play.
  • Style is stored, not typed. The project's art direction and each file type's own style instructions are added to the prompt of every picture generated for the world. A file type can also hold a style reference image whose look generations copy.
  • The GM keeps illustrating. When the GM creates a file in play, it gives it a picture when at least half the world's files of that type already have one, and every new place gets a picture and a map. A world whose characters all have portraits keeps getting portraits; a type nobody illustrated stays text.
  • Characters have expressions. A character's picture can carry one portrait per expression (happy, wary, angry …). When a character speaks in the story, the portrait changes to the expression the GM picked. See expressions.
  • Pictures in play can be free. The player's image bank switch decides whether the GM's new pictures come from Craft's image bank for free, or are drawn on the player's own image model at its price. See the image bank.
  • Generating costs energy or credits; uploading costs nothing. Each surface's price is in energy and credits.

Adding a picture to a file

To generate a new picture for a file, click the picture slot and pick Generate with AI. To use a picture someone already has, click the picture slot and pick Upload, or Add from Studio for art you already made in Craft. Either way, the file ends up with an image object whose url is on Craft's own media host. A link to another site, or a picture pasted in as a data: URL, is refused.

Generate with AI lets you write a prompt or build one from the file, and pick a model. A picture's settings set its focal point, add an overlay and make a cutout. You can also ask Orbit to illustrate files for you.

How to request, upload and write prompts, and every limit: generating images.

Keeping one style

Three settings shape every generated picture, so prompts can describe only the subject:

  • The project's art direction, a short paragraph on medium, palette, light and mood (project settings).
  • A file type's style instructions, added after the art direction for that type's files, such as plain dark backgrounds for item icons. They live in the file type's settings, under Image Style Instructions, or for every type at once in the project's Settings → Image Generation. A location type's text styles its maps as well as its pictures, so keep it about the world's look and leave map-only words out of it.
  • A file type's reference image, a picture whose art style (not its subject) generations copy. It lives in the file type's settings, under Reference image (and Map background reference image for a location type). Only image models that can edit take one. A location type has a second one, the map background reference image, used only for its maps: a look meant for maps goes there (a map's look).

Keep a type's style instructions to what its pictures show (framing, a plain background, an icon centered) and leave the medium, palette and mood to the art direction: when both name a look, the pictures follow one or the other. How to set both, in order, and what to do with a game system's styles: setting a world's image style.

Set them before the first batch. Changing them later restyles nothing that was already made.

Doing it well

  • Write the subject, not the style. Who or what, the pose or moment, the setting. The stored style supplies the rest; style words repeated in a prompt fight it.
  • Build the prompt from the file. Use its description, appearance and place in the world, so the picture matches what players read.
  • Illustrate the files players meet. Characters, creatures, places and items first. Rules and GM notes rarely need pictures.
  • Finish a type, not a sample. The GM only adds pictures to types where at least half the files have one, so a sparsely illustrated type stops growing art in play.
  • Make the main portrait good first. Expressions and cutouts are drawn from it and keep its face, outfit and style.
  • Say how many before a batch. Generations spend you's energy. Name the count, use one good prompt per file, and stop when the energy runs out.

Mistakes

  • A made-up URL. A link to another site is refused, and an invented one on Craft's host saves but shows nothing. Generate or upload the picture first.
  • A bare link instead of an object. A string is turned into { "url": … }, but keep writing the object.
  • Regenerating over a good picture. The file's old picture is gone (it stays in the Studio).
  • A style paragraph in every prompt. Stored once, the style reaches every surface; pasted into prompts, it drifts.
  • Expressions before the portrait is final. Replacing the portrait later leaves expressions of a different face. Generate them again.
  • An expression name that isn't on the list. The portrait can't change to it. See expressions.

When a picture doesn't appear

A requested picture usually lands within a minute or two. When it doesn't, the picture slot shows an error, a spinner that doesn't end, or nothing. Each cause below says what you see and what to do.

  • Image generation is off. Orbit makes pictures only while image generation is on in Orbit's settings, a tab of the drawer that opens when you click the token count above Orbit's message box. With it off, Orbit's image request is dropped and the rest of the write still saves, so the slot stays empty. Turn it on and ask again. In a game, with the image bank off (Use Craft Image Bank (Free), on the Images tab of the lobby's game settings, or in the Images section of Player Preferences during a game), the player's Image generation switch beside it turns the GM's new pictures off.
  • Not enough energy or credits. The pictures the balance covers start, in this order: the ones asked for, then covers for new files, then maps for new places. The rest show an error that names what was needed and what was available; a map that didn't fit is skipped without one. Once the balance covers them (energy and credits), ask again for the files still without art.
  • A free account gets the free image model. On the free plan, when you aren't paying with credits, a picked image model outside the free ones is switched to the free one instead of being refused. Pictures still come, but they can look different from the rest of the world. Credits or a subscription bring back the model you picked.
  • The image model refused the prompt. The error says it was a content policy violation. Rewrite the prompt rather than sending the same one again.
  • It failed or took too long. A generation that runs past a minute or two is stopped, and the provider can fail one. The slot shows the error, a failed picture isn't charged, and a picture the request was replacing is put back on the file. Ask again once; if it fails again, try another image model.
  • A spinner that doesn't end. The generation stopped before it could save a result. After 10 minutes the mark counts as dead and the slot shows empty (how a picture shows). Ask again.
  • An empty slot right after the request. The request never ran: it was written on a field that still had a picture (url set), or on an image field inside another field rather than at the top of the file. The leftover mark can hide a picture that was there. Ask again on a top-level image field, clearing its url first.

Reference

  • Expressions: The faces a character's portrait can show, how they are listed on the type and stored on the picture, and how the GM picks one.
  • Generating images: Every way to make or add a picture (requests, uploads, style, references, prompts), and the limits and costs of each.
  • The image bank: Craft's library of ready-made art that the GM searches before it draws, what the player's switch does, and what stays paid.
  • Image fields: The image object every picture is stored as, key by key, and the rules a saved picture must meet.