kirikiri · tutorial · engine
Ein Kirikiri- / KAG-Visual-Novel ins Deutsche übersetzen
Übersetze Kirikiri- / KAG-Visual-Novels ins Deutsche mit RuneTranslate — es liest gepackte .xp3-Archive automatisch, übersetzt KAG-.ks-Szenarien und PSB-Szenen und exportiert eine patch.xp3, die das Spiel automatisch lädt.
Kirikiri (吉里吉里) und seine KAG-Szenarioschicht treiben einen riesigen Teil japanischer Visual Novels an. Der Haken: Kirikiri packt seine Skripte, Grafik und Audio in .xp3-Archive, und viele Studios nutzen darüber eine eigene Archivvariante. Deshalb hat Kirikiri den Ruf, schwer zu übersetzen zu sein. Diese Anleitung führt durch das Ganze von Anfang bis Ende mit RuneTranslate: die .xp3 lesen, die KAG-.ks-Szenarien übersetzen und einen Patch exportieren, den das Spiel automatisch lädt.
Was du brauchst
- RuneTranslate für Windows oder Linux — kostenlos, jede Engine und jeder Anbieter außer RuneLingua freigeschaltet.
- Einen Kirikiri-Spielordner — das Verzeichnis mit der Spiel-
.exeund einem oder mehreren.xp3-Archiven (häufigdata.xp3,scenario.xp3usw.). Signierte KirikiriZ-Builds mit.exe.emb/.xp3.sig-Dateien werden ebenfalls erkannt. - Eine Zielsprache — Englisch, Spanisch, Französisch, Deutsch, Portugiesisch, Russisch, Chinesisch, Italienisch, Türkisch, Vietnamesisch und über 20 weitere.
- Einen Übersetzungsanbieter. Visual Novels sind dialoglastig, also liest meist ein LLM (OpenAI / Anthropic) oder DeepL am besten; das kostenlose Google Translate funktioniert sofort.
Schritt 1: Das Spiel öffnen und die XP3 auspacken
Starte RuneTranslate, klicke auf Neues Projekt und richte es auf das Verzeichnis des Kirikiri-Spiels. Die Engine-Erkennung läuft automatisch. Der eingebaute XP3-Leser öffnet den Archivindex — einschließlich des 17-Byte-Komprimierter-Index-Headers, den große Archive nutzen — und holt die Szenariodateien heraus. Deine Originalarchive werden nie verändert.
Gepackte Archive öffnen sich automatisch, einschließlich des neueren Formats, das manche jüngeren Veröffentlichungen nutzen, für die Titel, die RuneTranslate erkennt. Ein paar seltene Formate werden noch nicht erkannt.
Schritt 2: Wie Kirikiri-Dialog extrahiert wird
Kirikiri speichert Dialog in KAG-.ks-Szenarioskripten. RuneTranslate parst sie und listet den übersetzbaren Text im Editor auf:
- Dialog und Erzählung — die rohen Szenariozeilen.
- Intelligente Attribut-Extraktion — lesbarer Text in Tags wie
[ruby/],[ch text="..."],[name text="..."]und[button text="..."]wird herausgezogen und übersetzt, während die Tag-Struktur selbst bewahrt bleibt.
KAG-Inline-Steuer-Tags werden hinter numerischen [[K#]]-Platzhaltern maskiert, bevor irgendetwas den Anbieter erreicht, sodass die Maschine die Formatierung der Engine nicht brechen kann. Manche KirikiriZ-Spiele liefern ihr Szenario außerdem als kompiliertes PSB-.scn-Binary aus (das PSB\0-Format) — RuneTranslate parst und packt Standard-PSB-Szenarien (Formatversionen 1 bis 4) ebenfalls neu, sodass diese Spiele sich genau wie Textskripte übersetzen.
Schritt 3: Übersetzen und prüfen
Wähle einen Anbieter und starte. Für Figurenstimme und stilisierte Sprache liest ein LLM wie OpenAI oder Anthropic am besten; DeepL ist schnell und sauber für Erzähltext; das kostenlose Google Translate deckt Menüs ab. Glossariere deine Besetzung und wiederkehrende Begriffe zuerst, damit jede Route Namen einheitlich darstellt — siehe Glossar 101. In der kostenlosen Stufe ist die Übersetzung maßvoll gedrosselt — grob 2× langsamer bei den KI-Anbietern, weniger bei den kostenlosen Anbietern — bei identischer Ausgabequalität; bezahlte Stufen laufen mit voller Geschwindigkeit und ergänzen Übersetzungsspeicher.
Jede Zeile landet im Editor neben ihrer Quelle. Bearbeite inline (speichert beim Verlassen des Feldes oder mit Strg+Enter), nutze Suchen & Ersetzen oder lass den optionalen KI-Refiner für einen kontextbewussten Zweitdurchgangs-Korrekturlauf laufen — wertvoll bei langen VN-Routen.
Schritt 4: Einen Patch exportieren
Klicke auf Exportieren. RuneTranslate schreibt das übersetzte Szenario als lose Dateien plus einen Start-Hook und, wo es hilft, eine flache patch.xp3. Es nutzt zwei Override-Pfade, weil keiner allein universell ist:
- Lose Dateien + Start-Hook — der
addAutoPath-Aufruf des Hooks hebt lose Dateien über die Archive des Spiels. Weil verschiedene Builds einen anderen Init-Einstiegspunkt ausführen, schreibt RuneTranslate den Hook unter allen drei Namen, die Spiele nutzen —AfterInit2.tjs,xAfterInit2.tjsundxAfterInit.tjs—, sodass derjenige, den das Spiel aufruft, ihn aufgreift. - patch.xp3 — Kirikiri bindet
patch.xp3/patch2.xp3automatisch mit höherer Priorität als die eigenen Archive des Spiels ein („later paths win“), sodass es überschreibt, selbst wenn ein Spiel den Start-Hook deaktiviert. Der Patch wird in einer Form geschrieben, die das Spiel akzeptiert. Manche Builds lehnen eine zusätzlichepatch.xp3ab, sodass bei diesen der Lose-Datei-Hook der Pfad ist, der die Übersetzung trägt.
Die Ausgabe ist deine Übersetzung, neben dem Originalspiel abgelegt. Starte die .exe, und es spielt in deiner Zielsprache.
Bekannte Einschränkungen
- Ein seltenes gepacktes Archivformat, das die App noch nicht erkennt, wird nicht unterstützt. Die meisten Handelsspiele öffnen sich, aber nicht jeder Ausreißer.
- Nicht standardmäßige / MDF-komprimierte PSB-
.scn-Szenarien werden übersprungen; nur Standard-PSB (Versionen 1–4) wird unterstützt. - Kompilierter oder tokenisierter KAG-
.ks-Bytecode (binäres /jk-Magic, das sich nicht zu Text dekodieren lässt) wird übersprungen — nur lesbare KAG-Skripte und Standard-PSB-Szenarien werden geparst. - Bildtext (Logos, handgezeichnete UI, CG-Beschriftungen) gehört nicht zu den Skripten; übersetze ihn im Image Studio, das Bilder direkt aus den XP3-Archiven liest (TLG inklusive) und die übersetzte Grafik auf demselben Weg ausliefert wie die Skripte.
Warum das einfacher ist als der alte Weg
Der manuelle Weg bedeutete, das Archivformat zu identifizieren, die XP3 mit einem separaten Entpack-Tool zu extrahieren, den lesbaren Text in KAG-Tags von Hand zu finden, ihn zu übersetzen, ohne das Markup zu brechen, und dann neu zu packen oder einen Override-Pfad korrekt zu verdrahten. RuneTranslate faltet die ganze Kette — auspacken, extrahieren, Tags maskieren, übersetzen, sowohl den losen Hook als auch die patch.xp3 bauen — in ein paar Klicks, mit offenem Editor, sodass du die Formulierung steuerst.
Siehe die Kirikiri-Engine-Seite für die vollständige Funktionsliste, lies die Ren'Py-Anleitung für eine andere Visual-Novel-Engine oder lade RuneTranslate herunter und probiere es an einem echten Spiel aus.
Weiterführende Lektüre
Bereit, RuneTranslate auszuprobieren?
Der Free-Tarif schaltet jede Engine + jeden Übersetzungsanbieter außer RuneLingua frei. Supporter ($3.99/Mon.) schaltet volle Geschwindigkeit frei.
Für Windows, Mac & Linux herunterladen
