Ebene 1panelwave.json · CC BY 4.0
JSON Schema 2020-12 · CC BY 4.0
Ein offenes Format für Graphic Novels für den Bildschirm
panelwave.json beschreibt ein ganzes Werk – Panels und Ebenen, Seitenlayouts pro Bildschirm, Live-Text-Sprechblasen, Video und Sound, den Story-Graphen, Varianten und Paywall-Regeln. Öffentlich, dokumentiert, versioniert. Deine Inhalte, dein Format.
{
"id": "sb-07",
"characterId": "mira",
"text": {
"en-US": "Something's not right here.",
"de-DE": "Hier stimmt etwas nicht.",
"ja-JP": "何かがおかしい。"
},
"shape": { "x": 0.58, "y": 0.06, "w": 0.32, "h": 0.16 },
"balloonConfig": {
"balloonType": "whisper",
"tail": { "position": 210, "length": 40, "curve": "left" }
}
}StrukturElf Eigenschaften auf oberster Ebene · drei davon Pflicht
Ein vollständiges Datenmodell fürs Erzählen
Jede ID ist ein String, jeder sichtbare Text liegt pro BCP-47-Locale vor, und eigene Felder sind unter x- willkommen.
| Eigenschaft | Pflicht | Was sie enthält |
|---|---|---|
| panelwave | ja | Formatversion und Schema-Verweis |
| meta | ja | Titel, Creators, Locales, Figuren, Altersfreigabe, Inhaltswarnungen, Lizenz |
| chapters | ja | Panels, der Story-Graph, Seitenlayouts pro Format, optional die unendliche Leinwand |
| assets | — | Bilder, Video, Audio, Untertitel mit responsiven Varianten; Ordner |
| variables | — | Typisierte Story-Variablen in fünf Geltungsbereichen |
| settings | — | Typografie, Sprechblasen-Vorlagen, UI-Voreinstellungen, Vorladen, Format-Vorlagen |
| localization | — | Übersetzungsstand und Glossar (Metadaten für die Erstellung) |
| extras | — | Cover, Charakterbögen, Interviews, Bonus-Artwork, Blick hinter die Kulissen |
| paywall | — | Regeln pro Werk, Kapitel, Panel oder Extras; Produkte |
| tracking | — | Event-Tracking mit Einwilligung |
| ui | — | Branding und Bedienelemente des Readers |
BeispieleSchema-gültige Schnipsel
Kopieren, einfügen, validieren
So sieht es aus
{
"id": "ch-01",
"title": { "en-US": "Night Shift" },
"panels": {
"p1": { "layers": [{ "id": "art", "kind": "image", "assetId": "img-p1" }] },
"p2": { "layers": [{ "id": "art", "kind": "image", "assetId": "img-p2" }] },
"p3": { "layers": [{ "id": "art", "kind": "image", "assetId": "img-p3" }] }
},
"graph": {
"entry": "p1",
"edges": [
{ "from": "p1", "to": "p2" },
{ "from": "p2", "to": "p3", "transition": { "type": "fade", "durationMs": 400 } }
]
}
}WerkzeugeArbeiten mit PanelWave-Dateien
Schema · Format 1.7.0JSON Schema 2020-12Validiere mit AJV oder jedem anderen 2020-12-Validator.GitHub @panelwave/cli 1.2.0 · MITvalidate · bundle · diff · upgradenpx @panelwave/cli validate panelwave.json – funktioniert offline, bringt Format 1.7.0 mit.npm @panelwave/types 1.2.0 · MITTypeScript-TypenJede Schema-Definition als TypeScript-Interface, bis Format 1.7.0.npm
Aktuelle Releases (4. Okt. 2026): Format 1.7.0 · @panelwave/cli 1.2.0 · @panelwave/types 1.2.0 · @panelwave/player 1.2.0 · @panelwave/mcp 0.1.0 – welches Release welches Format unterstützt
RevisionenVersioniert und stabil
Neue Versionen ergänzen nur. Eine 1.0-Datei bleibt gültig.
Minor-Versionen fügen nur hinzu, nichts geht kaputt. Aktuell ist 1.7.0: Lineare Kapitel kommen ganz ohne Verbindungen aus und folgen einfach der Panel-Reihenfolge. Entscheidungen bringen ihre eigenen Beschriftungen mit.
CC BY 4.0Schema · Doku
| 1.7 | Okt. 2026 | Kapitel ohne Verbindungen folgen der Panel-Reihenfolge; beschriftete Entscheidungen, Hotspots als Buttons, Lettering-Farbe, Variablen-IDs in snake_case, x-Felder an Panels und Extras |
| 1.6 | Sep. 2026 | Mehrere Produkte pro Paywall-Regel, Anzeigeinfos für Produkte, Keyframe-Animationen für Ebenen, alternative Cover, Charakterbögen für Ensembles |
| 1.5 | Aug. 2026 | Portables Werkarchiv: Asset-Ordner und Übersetzungsstand |
| 1.4 | Juli 2026 | Unendliche Leinwand: Platzierung in Weltkoordinaten, Kamerafahrten entlang von Verbindungen, vertikales Lesen im Webtoon-Stil aus demselben Modell |
| 1.3 | Juli 2026 | Stilvorlagen für Text und Sprechblasen; der Erzählerkasten als zehnter Sprechblasentyp |
| 1.2 | Juli 2026 | Schlankere Manifeste: optionale MIME-Typen, vererbte Übergänge |
| 1.1 | Juli 2026 | Videopanels: Abspielmodi, Startmodi, rückwärts laufende Varianten, Posterbilder |
| 1.0 | Q1 2026 | Panels, Kapitel, Graph-Ablauf, Assets, Variablen + JSON Logic, mehrsprachiger Text, Ausgabeformate, Paywall, Tracking, Plugins |
Gestalte den Standard mit.
Melde Probleme, schlag Verbesserungen vor oder schick einen Pull Request. Offen, versioniert und für Creators gebaut.