Expressions
A character can have one portrait per expression: a happy face, a wary one, an angry one. When a character speaks in the story, the GM names the expression that fits the line, and the speaker's portrait changes to it. Two parts make this work:
- States, the list of expressions, belong to the character's file type. Every character of the type shares the list.
- Variations, the pictures, belong to each character's
image. Each variation is named after a state.
The list of expressions
A character type with no list of its own uses the defaults below, so every character has expressions with no setup. The list is edited in the character type's settings, on the Expressions tab. Editing starts from a copy of the defaults, and resetting goes back to them. Adding an expression from a character's own expressions gallery adds it to the type, so every character of that type gets it.
- At most 16 expressions, each name used once (without regard to case).
- Only character types have expressions.
| Name | What it looks like | When it's used |
|---|---|---|
neutral |
Calm, at-rest baseline expression. | Default delivery when no stronger emotion fits. |
happy |
Warm smile, bright eyes. | Joy, warmth, friendly greetings, good news. |
sad |
Downcast eyes, heavy expression. | Grief, loss, disappointment, bad news. |
angry |
Furrowed brow, hard stare, clenched jaw. | Rage, confrontation, threats, betrayal. |
surprised |
Wide eyes, raised brows, parted lips. | Shock, sudden reveals, unexpected arrivals. |
afraid |
Tense posture, fearful wide eyes. | Fear, panic, dread, fleeing danger. |
thoughtful |
Pensive gaze, hand near chin. | Weighing options, recalling memories, pondering. |
amused |
Wry half-smile, playful eyes. | Jokes, teasing, light irony, banter. |
determined |
Set jaw, steady focused stare. | Resolve, vows, rallying for action. |
embarrassed |
Flushed cheeks, sheepish averted gaze. | Awkwardness, flattery, being caught out. |
wary |
Guarded stance, narrowed searching eyes. | Suspicion, caution, distrust of strangers. |
smug |
Self-satisfied smirk, lifted chin. | Gloating, confidence, holding the upper hand. |
The pictures
Each expression's picture is a variation on the character's image,
with the state's name (image fields):
{
"image": {
"url": "https://media.craftrpgs.com/…/mira.webp",
"variations": [
{ "name": "happy", "url": "https://media.craftrpgs.com/…/mira-happy.webp" },
{ "name": "wary", "url": "https://media.craftrpgs.com/…/mira-wary.webp" }
]
}
}
- Generated expressions are drawn from the character's main portrait: a chest-up portrait with the same face, hair, outfit, art style and background, showing the expression its description gives. To start them, open the character, click View assets on its Expressions & Cutouts card, and click Generate Expressions.
- Uploaded expressions are any art you made yourself, one per expression square.
- An expression with no picture shows the main portrait instead.
- Removing an expression's picture removes its cutout too, since the cutout is cut from it.
Generating runs in the background, and you can leave the page: a notification says when it's done. Expressions are priced per picture, whatever the image model (energy and credits), and one that fails is not charged.
Cutouts
A cutout is a picture with its background removed. With cutouts, a
speaking character stands in the scene itself instead of sitting in a
round frame. The story view picks, in order: the cutout of the
expression being shown, the cutout of neutral, then the cutout of the
main portrait. To make them, use Create cutout in the picture's settings for the portrait, or Generate Cutouts in the character's View assets gallery for its expressions. Replacing the
main portrait clears its cutout, which no longer matches. A player who
reads the story as a chat instead of the story view sees no cutouts.
The project's Visual Novel Mode settings list every character with its portrait, cutouts and expressions, so you can see what's missing and fill it in bulk.
How the GM picks
The GM is given the names of every character type's expressions (or the defaults) and tags each spoken line with one. It is given the names only, so a name should say what it is. An expression a portrait doesn't have shows the main portrait.
The GM's own portrait has the default expressions. The narrator's face shows in the story only when its Show expressions setting is on and it has a portrait (project settings). Visual novels use the same expressions for their speakers.
A state's fields
name
The state's name, such as "happy". An image variation with the same name, compared without regard to case, is the picture for it.
Type: string, required, up to 64 characters.
Short and plain: wary, not guarded-and-suspicious. Renaming a state
cuts it off from the pictures saved under its old name, so generate or
upload them again.
description
What the face looks like in this state. A generated expression portrait is drawn from it.
Type: string, optional, up to 500 characters.
Write what shows on the face and in the posture: "Narrowed eyes, arms folded, leaning back".
instruction
Deprecated (GM Harness V1): when to use this state. The GM is now told the names only, so a name should say what it is.
Type: string, optional, up to 500 characters.
Say when it fits: "Suspicion, caution, distrust of strangers".