Character Cards are structured persona files that define a roleplay character in detail: who they are, how they speak, what situation they’re in, and how they open a conversation. LMSA supports the Character Card V2 specification — the same industry-standard format used by most AI roleplay tools — so you can import cards created elsewhere or build your own from scratch.Documentation Index
Fetch the complete documentation index at: https://docs.lmsa.app/llms.txt
Use this file to discover all available pages before exploring further.
What is Character Card V2?
Character Card V2 (chara_card_v2, spec version 2.0) is a structured data format that encodes a roleplay character’s complete profile into a set of named fields. Because it’s an open standard, a card created in one application can be imported and used in another.
Card fields
| Field | Purpose |
|---|---|
name | The character’s display name |
description | Background, appearance, and lore for the character |
personality | Key personality traits that shape how the character responds |
scenario | The context or setting for the roleplay — where and when the story takes place |
first_mes | The character’s opening message, sent at the start of every new chat |
mes_example | Example dialogue exchanges that demonstrate the character’s speech style and mannerisms |
Import a character card
LMSA can import Character Card V2 data from two file formats:.json— a plain JSON file containing the card data.png— an image with the card data embedded in the file’s metadata (a common format from tools like SillyTavern and Character Hub)
Obtain a character card file
Download a
.json or .png character card from a source you trust, or export one from another app.When you import a
.png character card, LMSA reads the character data from the image’s embedded metadata — not from the image itself. The character’s portrait (if any) is stored as part of the card data.Create a character card in LMSA
You can build a Character Card V2 entirely within LMSA, either by filling in the fields manually or by using AI generation to produce a complete card automatically.Manual creation
Switch to Character Card V2 mode
In the template editor, switch the mode selector from Basic to Character Card V2. The editor reveals the full set of card fields.
Fill in the fields
Complete each field —
name, description, personality, scenario, first_mes, and mes_example. All fields are optional, but the more detail you provide, the more consistent the character’s behavior will be.AI-generated character cards
AI character card generation requires LMSA Premium.
Tap AI Generate
Tap the AI Generate button in the editor. Enter a brief description of the character you want — name, role, genre, or any details you have in mind.
Review and edit
LMSA sends your description to the connected model and populates all the card fields with generated content. Review each field and edit anything that doesn’t fit your vision.