Characters
Create, import, and export character cards.
Card fields
A character card is a set of text fields that become part of the prompt. All fields support macros.
| Field | Purpose |
|---|---|
Name | The character's display name; also what the char macro resolves to. |
Description | The main body of who the character is. The largest single block sent to the model. |
Personality | Short trait summary appended to the character block. |
Scenario | The setting or situation the chat starts in. |
First message | The opening message. Alternate greetings add swipeable variants. |
Example messages | Sample dialogue parsed into few-shot turns that teach the model the character's voice. |
Avatar & background | Images for the chat UI. The avatar can also feed image generation as a reference. |
Prompt overrides
Two advanced fields override preset prompts for this character only: a system prompt that replaces the preset's system slot, and post-history instructions injected after the chat history, where they have the strongest effect on the next reply.
Leave both empty unless the card needs special steering; preset-level prompts cover the normal case.
Behavior settings
Each character carries its own trigger scripts, turn triggers, and regex scripts, so a card can ship its own automation. See the Scripting section for how these run.
In group chats, always active controls whether the character's block is always in the prompt or only when the character is talking or mentioned; match whole words tightens name-mention detection. A per-character reasoning effort default applies when the model supports it.
Import
Import PNG cards (spec v2 and v3), CHARX archives, and plain JSON. Drop the file on the characters page or use the import button; embedded avatars and greetings come along.
Cards from SillyTavern, RisuAI, and hub sites work as-is. Unknown extra fields are preserved where the spec allows so a later export does not lose them.
Export
Export any character in four formats:
| Format | Use it for |
|---|---|
png | The universal card format; works in SillyTavern, RisuAI, and most frontends. |
charx | The v3 archive format; keeps multiple assets alongside the card data. |
voxta | For the Voxta voice roleplay app. |
json | Raw card data for editing or tooling. |