Portrait states

Hero subscribers can create alternate versions of any NPC's portrait — different outfits, expressions, or contexts. Each portrait state costs 4 credits. The default portrait is the initial character portrait generated when the NPC was created; states are variations layered on top of it.

Creating a portrait state

Creating a portrait state

  1. Open an NPC in the Atlas NPCs tab
  2. In the portrait strip, click the + button
  3. Fill in the form:
    • Type — Outfit or Custom
    • State name — a short label (max 30 characters), e.g., "red ball gown" or "battle armor." This matters: the NPC will be aware of what they're wearing in the active state and may reference it in conversation
    • Base image — the default portrait, or a previous state to build on
    • Edit prompt — describe what you want to see (max 500 characters). For example: "wearing a red ball gown" or "battle armor with a cracked helmet"
  4. Submit — the state generates in the background and appears in the portrait strip when ready

Switching states

Switching portrait states

In the cinematic chat view, hover over the NPC's avatar and click the pencil icon. Select Change State to pick from the available portrait states. The NPC's portrait updates immediately, and they'll be aware of what they're wearing going forward.

Prompting tips

See the Prompt reference for more image prompting guidance.