Cara menerjemahkan game TyranoBuilder / TyranoScript ke bahasa Inggris

TyranoBuilder dan engine TyranoScript yang mendasarinya menggerakkan katalog besar visual novel Jepang indie — alternatif teknologi-web (HTML5 / JavaScript) bagi Kirikiri dan Ren’Py, dikirim entah sebagai folder HTML5 mandiri atau eksekutabel terbungkus-Electron. Skenarionya memakai sintaks .ks gaya-KAG yang sama seperti Kirikiri, sehingga teksnya mudah dijangkau begitu Anda tahu di mana ia berada. Panduan ini menuntun Anda menerjemahkan game TyranoBuilder dari ujung ke ujung dengan RuneTranslate, termasuk bagian yang dilewatkan sebagian besar alat: nama tampilan karakter.

Yang Anda butuhkan

• RuneTranslate untuk Windows — gratis, setiap engine dan penyedia terbuka.
• Sebuah game TyranoBuilder: folder HTML5 mandiri (direktori data/ dan tyrano/ lepas) atau build Electron (sebuah resources/app.asar yang menyimpan tyrano/tyrano.js dan data/scenario/*.ks). RuneTranslate mendeteksi keduanya.
• Sebuah bahasa target — Inggris, Spanyol, Prancis, Jerman, Mandarin, dan 30+ lainnya.
• Satu penyedia. Visual novel padat dialog, jadi sebuah LLM (OpenAI / Anthropic) atau DeepL membacanya paling baik; Google Translate gratis langsung bekerja.

Langkah 1: Buka folder game

Luncurkan RuneTranslate, klik New project, dan arahkan ke direktori game (atau folder yang berisi .exe untuk build Electron). Deteksi mengenali TyranoBuilder dari runtime tyrano/-nya plus skrip data/scenario/; untuk build Electron ia membaca app.asar langsung, jadi Anda tak pernah membongkar apa pun. Game asli Anda tidak pernah diubah.

Langkah 2: Bagaimana string diekstrak

RuneTranslate menarik teks yang bisa diterjemahkan dari setiap tempat TyranoBuilder menyimpannya:

• Skrip skenario — setiap berkas data/scenario/**/*.ks, termasuk _preview.ks dan cerminan system/_*.ks yang diandalkan build terenkripsi.
• UI dan config — tyrano/lang.js dan data/system/Config.tjs.
• Nama tampilan karakter — label pembicara yang ditampilkan di atas dialog (bagian berikutnya).

Tag KAG inline — [r] pemutus baris, [p] click-wait, [改ページ] pemutus halaman, [font color=...], dan tag bernama-JP — disamarkan di balik placeholder numerik [[U#]] sebelum apa pun mencapai penyedia, lalu dipulihkan saat ekspor, sehingga pemformatan bertahan utuh. Berkas .ks biner atau terenkripsi dideteksi lewat sniff UTF-8 dan tak pernah ditimpa.

Langkah 3: Nama karakter — bagian khusus-Tyrano

Skenario kerap menyapa pembicara dengan singkatan inline seperti [yuki] — sebuah ID karakter, bukan teks tampilan. RuneTranslate tak pernah menulis ulang referensi itu (itu akan merusak lookup karakter engine dan membuat adegan crash). Sebaliknya ia menerjemahkan nama tampilan dan menyuntikkan entri [chara_new name=... jname=...] yang benar ke data/system/chara_define.ks saat ekspor. Nama yang ditampilkan di layar diterjemahkan; ID yang dipakai skrip tetap tak tersentuh.

Langkah 4: Terjemahkan dan tinjau

Pilih penyedia dan jalankan. Sebuah LLM (OpenAI / Anthropic) membaca paling baik untuk suara karakter; DeepL cepat dan bersih untuk narasi; Google Translate gratis mencakup menu. Susun glosarium para pemeran dan istilah berulang Anda lebih dulu agar nama tampil identik di setiap route — lihat Glossary 101. Setiap baris mendarat di editor di samping sumbernya; edit inline (menyimpan saat blur atau Ctrl+Enter), pakai find & replace, atau jalankan AI refiner opsional untuk pass kedua sadar-konteks. Tier gratis dibatasi sedikit pada kecepatan — kira-kira separuh throughput berbayar pada penyedia AI — dengan kualitas keluaran yang identik.

Langkah 5: Ekspor build yang bisa dimainkan

Klik Export. Untuk game HTML5 mandiri, RuneTranslate menulis skrip .ks terjemahan, lang.js, config, dan chara_define.ks yang disuntikkan ke dalam salinan game. Untuk build Electron ia mengemas ulang app.asar yang dimodifikasi. Bagaimanapun Anda mendapat salinan utuh yang bisa dijalankan di lokasi yang Anda pilih — luncurkan dan ia berjalan dalam bahasa target Anda.

Keterbatasan yang diketahui

• Berkas .ks terenkripsi (terdeteksi sebagai non-UTF-8) dibiarkan tak tersentuh, sehingga skenario dalam build terenkripsi tak akan diterjemahkan.
• Teks gambar (logo, UI gambar tangan, keterangan CG) di luar cakupan terjemahan mesin.
• Plugin kustom yang membangun dialog saat runtime mungkin perlu perbaikan tangan cepat di editor.

Mengapa ini lebih mudah dari cara lama

Rute manual berarti membongkar app.asar, menemukan setiap berkas .ks (termasuk cerminan sistem yang mudah terlewat), menerjemahkan di sekitar tag KAG dengan tangan, memikirkan penyuntikan nama-karakter, lalu mengemas ulang asar tanpa merusaknya. RuneTranslate melipat seluruh rantai menjadi beberapa klik, dengan editor terbuka sehingga Anda mengendalikan kata-katanya.

Lihat halaman engine TyranoBuilder untuk daftar fitur lengkap, baca panduan Kirikiri untuk engine KAG terkait, atau unduh RuneTranslate dan cobalah pada game sungguhan.