Ein Kirikiri- / KAG-Visual-Novel ins Englische übersetzen

Kirikiri (吉里吉里) und seine KAG-Szenarioschicht treiben einen riesigen Teil japanischer Visual Novels an — einschließlich des meisten kommerziellen Bishoujo-Katalogs. Der Haken: Kirikiri packt seine Skripte, Grafik und Audio in verschlüsselte .xp3-Archive, und viele Studios legen darüber ein spielspezifisches Verschlüsselungsschema. 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, Verschlüsselung handhaben, die KAG-.ks-Szenarien übersetzen und einen Patch exportieren, den das Spiel automatisch lädt.

Was du brauchst

• RuneTranslate für Windows — kostenlos, jede Engine und jeder Anbieter freigeschaltet.
• Einen Kirikiri-Spielordner — das Verzeichnis mit der Spiel-.exe und einem oder mehreren .xp3-Archiven (häufig data.xp3, scenario.xp3 usw.). 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.

Ist das Archiv verschlüsselt, versucht RuneTranslate, es mit einer Bibliothek von rund zwei Dutzend portierten GARbro-Verschlüsselungsschemata zu entschlüsseln, plus einem generischen Ein-Byte-XOR-Brute-Solver für einfachere Datei-Verwürfelungen. Die meisten Handelsspiele fallen in eines davon. Schemata, die pro-Archiv-Laufzeitzustand oder einen studiogehaltenen Schlüssel brauchen, bleiben nicht unterstützt — das sind die wirklich verschlossenen Ausreißer.

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 unverschlüsselte 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 Scrapern — 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.tjs und xAfterInit.tjs —, sodass derjenige, den das Spiel aufruft, ihn aufgreift.
• patch.xp3 — Kirikiri bindet patch.xp3 / patch2.xp3 automatisch 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. Bei verschlüsselten Builds werden seine Einträge mit dem eigenen Schema des Spiels vorab verschlüsselt. Beachte, dass Builds, die Archivsignaturen erzwingen, eine zusätzliche patch.xp3 ablehnen, 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

• Verschlüsselte XP3 mit einem spielspezifischen Schema, das Laufzeitzustand, Lookup-Tabellen oder einen studiogehaltenen Schlüssel braucht, wird nicht unterstützt — rund zwei Dutzend GARbro-Schemata plus ein XOR-Brute-Solver sind eingebaut, was die meisten Handelsspiele abdeckt, aber nicht jeden Ausreißer.
• Verschlüsselte / MDF-komprimierte PSB-.scn-Szenarien werden übersprungen; nur unverschlüsseltes PSB (Versionen 1–4) wird unterstützt.
• Kompilierter oder tokenisierter KAG-.ks-Bytecode (binäres / jk-Magic, das sich nicht zu Text entwürfelt) wird übersprungen — nur lesbare KAG-Skripte und unverschlüsselte PSB-Szenarien werden geparst.
• Bildtext (Logos, handgezeichnete UI, CG-Beschriftungen) wird nicht übersetzt — außerhalb des Umfangs der maschinellen Übersetzung.

Warum das einfacher ist als der alte Weg

Der manuelle Weg bedeutete, das Verschlüsselungsschema zu identifizieren, die XP3 mit GARbro 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 — entschlüsseln, 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.