Ein TyranoBuilder- / TyranoScript-Spiel ins Englische übersetzen

TyranoBuilder und die zugrunde liegende TyranoScript-Engine treiben einen großen Katalog japanischer Indie-Visual-Novels an — die Web-Tech-(HTML5- / JavaScript-)Alternative zu Kirikiri und Ren'Py, ausgeliefert entweder als eigenständige HTML5-Ordner oder als Electron-verpackte ausführbare Dateien. Seine Szenarien nutzen dieselbe KAG-artige .ks-Syntax wie Kirikiri, sodass der Text leicht erreichbar ist, sobald du weißt, wo er lebt. Diese Anleitung führt durch das Übersetzen eines TyranoBuilder-Spiels von Anfang bis Ende mit RuneTranslate, einschließlich des Teils, den die meisten Tools verpassen: Figuren-Anzeigenamen.

Was du brauchst

• RuneTranslate für Windows — kostenlos, jede Engine und jeder Anbieter freigeschaltet.
• Ein TyranoBuilder-Spiel: einen eigenständigen HTML5-Ordner (lose data/- und tyrano/-Verzeichnisse) oder ein Electron-Build (eine resources/app.asar, die tyrano/tyrano.js und data/scenario/*.ks enthält). RuneTranslate erkennt beide.
• Eine Zielsprache — Englisch, Spanisch, Französisch, Deutsch, Chinesisch und über 30 weitere.
• Einen Anbieter. Visual Novels sind dialoglastig, also liest ein LLM (OpenAI / Anthropic) oder DeepL am besten; das kostenlose Google Translate funktioniert sofort.

Schritt 1: Den Spielordner öffnen

Starte RuneTranslate, klicke auf Neues Projekt und richte es auf das Spielverzeichnis (oder den Ordner mit der .exe bei Electron-Builds). Die Erkennung erkennt TyranoBuilder an seiner tyrano/-Laufzeit plus data/scenario/-Skripten; bei Electron-Builds liest es die app.asar direkt, sodass du nie etwas auspackst. Dein Originalspiel wird nie verändert.

Schritt 2: Wie Strings extrahiert werden

RuneTranslate zieht übersetzbaren Text aus allem, wo TyranoBuilder ihn speichert:

• Szenarioskripte — jede data/scenario/**/*.ks-Datei, einschließlich _preview.ks und der system/_*.ks-Spiegel, auf die verschlüsselte Builds angewiesen sind.
• UI und Konfiguration — tyrano/lang.js und data/system/Config.tjs.
• Figuren-Anzeigenamen — die Sprecherbeschriftungen, die über dem Dialog gezeigt werden (nächster Abschnitt).

KAG-Inline-Tags — [r]-Zeilenumbrüche, [p]-Klick-Warten, [改ページ]-Seitenumbrüche, [font color=...] und JP-benannte Tags — werden hinter numerischen [[U#]]-Platzhaltern maskiert, bevor irgendetwas den Anbieter erreicht, und dann beim Export wiederhergestellt, sodass die Formatierung intakt überlebt. Binäre oder verschlüsselte .ks-Dateien werden per UTF-8-Sniff erkannt und nie überschrieben.

Schritt 3: Figurennamen — der Tyrano-spezifische Teil

Szenarien sprechen einen Sprecher oft mit einem Inline-Kürzel wie [yuki] an — einer Figuren-ID, nicht Anzeigetext. RuneTranslate schreibt diese Referenzen nie um (das würde die Figuren-Suche der Engine brechen und die Szene zum Absturz bringen). Stattdessen übersetzt es den Anzeigenamen und injiziert beim Export einen ordentlichen [chara_new name=... jname=...]-Eintrag in data/system/chara_define.ks. Der auf dem Bildschirm gezeigte Name wird übersetzt; die ID, die das Skript nutzt, bleibt unangetastet.

Schritt 4: Übersetzen und prüfen

Wähle einen Anbieter und starte. Ein LLM (OpenAI / Anthropic) liest am besten für Figurenstimme; 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 Namen über jede Route hinweg einheitlich erscheinen — siehe Glossar 101. 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 zweiten Durchgang laufen. Die kostenlose Stufe ist bei der Geschwindigkeit maßvoll gedrosselt — grob der halbe bezahlte Durchsatz bei KI-Anbietern — bei identischer Ausgabequalität.

Schritt 5: Ein spielbares Build exportieren

Klicke auf Exportieren. Für eigenständige HTML5-Spiele schreibt RuneTranslate die übersetzten .ks-Skripte, lang.js, die Konfiguration und die injizierte chara_define.ks in eine Kopie des Spiels. Für Electron-Builds packt es eine modifizierte app.asar neu. So oder so bekommst du eine vollständige, startklare Kopie am von dir gewählten Ort — starte sie, und sie spielt in deiner Zielsprache.

Bekannte Einschränkungen

• Verschlüsselte .ks-Dateien (als Nicht-UTF-8 erkannt) werden unangetastet gelassen, sodass Szenarien in einem verschlüsselten Build nicht übersetzt werden.
• Bildtext (Logos, handgezeichnete UI, CG-Beschriftungen) ist außerhalb des Umfangs der maschinellen Übersetzung.
• Eigene Plugins, die Dialog zur Laufzeit bauen, brauchen vielleicht eine schnelle Handkorrektur im Editor.

Warum das einfacher ist als der alte Weg

Der manuelle Weg bedeutete, die app.asar auszupacken, jede .ks-Datei zu finden (einschließlich der leicht übersehbaren System-Spiegel), von Hand um die KAG-Tags herum zu übersetzen, die Figurennamen-Injektion herauszuarbeiten und dann die asar neu zu packen, ohne sie zu beschädigen. RuneTranslate faltet die ganze Kette in ein paar Klicks, mit offenem Editor, sodass du die Formulierung steuerst.

Siehe die TyranoBuilder-Engine-Seite für die vollständige Funktionsliste, lies die Kirikiri-Anleitung für die verwandte KAG-Engine oder lade RuneTranslate herunter und probiere es an einem echten Spiel aus.