Docs / Developer / Format support matrix

Format support matrix

Auto-generated from live adapters (bun run scripts/format-matrix.ts).
Canonical schema version: 1.
Generated: 2026-11-03.

How to use

bun run bunzai formats
bun run bunzai inspect path/to/card.png
bun run bunzai convert in.png out.json --to sillytavern
bun run bunzai validate path/to/card.json

Portable character format for targets that accept Character Card v3:
SillyTavern / CCv3 (sillytavern adapter).

Characters (11)

id kind writes label
agnai character .json Agnai (Agnaistic) character (.json)
backyard character .json Backyard.ai / Faraday character (legacy json)
byaf character .byaf Backyard archive (.byaf)
janitor character .png JanitorAI character (PNG for the avatar importer)
lumiverse character .json, .charx Lumiverse character (ST + modules)
pygmalion character .json, .png Pygmalion character (flat JSON / PNG)
risu character .charx RisuAI .charx (zip: card.json + assets)
rolecall character .json RoleCall character card (v3, png/json)
saucepan character .png Saucepan companion (PNG for the Companion Importer)
sillytavern character .json, .png SillyTavern character card (v2/v3, png/json)
vaud-json character .json Bunzai native (.json)

Lorebooks (9)

id kind writes label
agnai-lorebook lorebook .json Agnai memory book (json)
janitor-lorebook lorebook .json JanitorAI lorebook (ST world info for Scripts > Import JSON)
marinara-lorebook lorebook .json Marinara-Engine lorebook (native .marinara.json export)
novelai-lorebook lorebook .lorebook NovelAI lorebook (native export .lorebook / json)
risu-lorebook lorebook .json RisuAI lorebook (native export json)
rolecall-lorebook lorebook .json RoleCall lorebook (v1 export json)
rolecall-compendium lorebook .json RoleCall compendium export (compendium.json)
saucepan-lorebook lorebook .json Saucepan lorebook (ST world info for the Lorebook Importer)
sillytavern-lorebook lorebook .json SillyTavern world info (worldbook json)

Personas (4)

id kind writes label
lumiverse-persona persona .json Lumiverse persona (account object)
marinara-persona persona .json Marinara persona (theming and stat bars ride sealed)
rolecall-persona persona .json RoleCall persona (rcpersona / RC persona-card export)
sillytavern-persona persona .json SillyTavern personas backup (default persona; the rest ride sealed)

Packs (1)

id kind writes label
image-pack pack .zip Media pack (ZIP pictures/sounds or raster picture)

Presets (4)

id kind writes label
lumiverse-preset preset .json Lumiverse preset (wrapper import; exports as an ST flat preset)
marinara-preset preset .json Marinara-Engine prompt preset (marinara_preset export)
rolecall-preset preset .json RoleCall preset export (ST grammar + macros/choice groups/readme)
sillytavern-preset preset .json SillyTavern completion preset (flat json)

Script Sheets (1)

id kind writes label
rolecall-script-sheet scriptsheet .json RoleCall Script Sheet export (one instruction, with the blocks it sends)

Promptbooks (1)

id kind writes label
bunzai-promptbook promptbook .json Bunzai Promptbook

Regex sets (5)

id kind writes label
lumiverse-regex regex .json Lumiverse regex scripts (versioned export file)
marinara-regex regex .json Marinara-Engine regex scripts (API dump array)
risu-regex regex .json RisuAI regex scripts (.risum module or customscript array)
rolecall-regex regex .json RoleCall regex script (chat-pipeline find/replace set)
sillytavern-regex regex .json SillyTavern regex scripts (bare array or card extensions.regex_scripts)

Quick replies (1)

id kind writes label
sillytavern-quickreply quickreply .json SillyTavern quick-reply set

Tools (0)

id kind writes label
(none yet) tool The studio edits this kind, but no import/export format exists yet.

Dice (0)

id kind writes label
(none yet) dice The studio edits this kind, but no import/export format exists yet.

Formulas (0)

id kind writes label
(none yet) formula The studio edits this kind, but no import/export format exists yet.

Trackers (0)

id kind writes label
(none yet) tracker The studio edits this kind, but no import/export format exists yet.

Skills (0)

id kind writes label
(none yet) skill The studio edits this kind, but no import/export format exists yet.

Prompt formats (1)

id kind writes label
sillytavern-promptformat promptformat .json SillyTavern prompt format (instruct and context templates)

Agents (1)

id kind writes label
bunzai-agent agent .json Bunzai Agent

Drawings (0)

id kind writes label
(none yet) htmldoc The studio edits this kind, but no import/export format exists yet.

Notes

  • Detection is content-sniff, not only extension. Prefer bunzai label when unsure.
  • Same-format round-trips aim for lossless where fixtures prove it (see adapter tests + samples/).
  • Cross-format convert keeps what the target can express; use export honesty in the studio UI for drop notes.
  • Target-specific fields may be omitted during cross-format conversion; review the export report.

Samples

Folder Purpose
samples/sillytavern/ CCv2/v3 + synthetic-character.png
samples/rolecall/ RC character + lorebook
samples/risu/ .charx + card json
samples/agnai/ native Agnai
samples/backyard/ .byaf archives
samples/pygmalion/ classic flat
samples/lumiverse/ ST + Lumi extensions
samples/chub/ ST + extensions.chub
samples/marinara/ native lorebook envelope + prompt preset
samples/novelai/ lorebook