When a card breaks, follow the next fix.
Start with the symptom: JSON errors, a PNG with only an avatar, a blank first message, or a Lorebook that does not trigger.
Each issue follows “What happened → What to do next”. Client prompt templates and field support can differ, so recheck after fixing.
JSON will not importSee fix
The file is not valid JSON, or quotes and newlines were damaged during editing.
Export V2 JSON again; keep explanatory text outside the code block.
PNG has only an avatarSee fix
Compression or re-encoding may have removed embedded card metadata.
Use the original PNG, or keep a JSON backup from the same export.
First message is blankSee fix
The chosen client has no opening message to display.
Fill in first_mes in the workspace and run the export check again.
Lorebook does not triggerSee fix
The test text does not contain a keyword, or the entry is disabled.
Check keywords, case settings, and the enabled state.
Clients behave differentlySee fix
Prompt templates, field precedence, and extension support can vary by client.
Inspect imported fields, then verify again with the target client template.
Return to the character-card workspace to edit real fields, run checks, and export.