Cara menerjemahkan game Ren’Py ke bahasa Inggris (panduan lengkap)

Ren’Py adalah engine berbasis Python di balik sebagian besar visual novel Barat dan Jepang — dari jam itch.io mungil hingga judul DLsite komersial. Ia salah satu engine paling bersih untuk diterjemahkan: RuneTranslate tak pernah menimpa skrip asli, ia melapiskan terjemahan di atasnya sehingga game tetap utuh. Panduan ini menuntun Anda menerjemahkan game Ren’Py ke bahasa Inggris (atau bahasa apa pun) dari ujung ke ujung dengan RuneTranslate, termasuk tiga bentuk game Ren’Py dikirim — sumber .rpy lepas, hanya-.rpyc terkompilasi, dan .rpa terarsip.

Yang Anda butuhkan

• RuneTranslate untuk Windows — gratis, setiap engine dan penyedia terbuka.
• Sebuah folder game Ren’Py. Ini adalah direktori yang berisi .exe game plus subfolder game/ (yang menyimpan berkas .rpy, .rpyc, dan/atau .rpa).
• Sebuah bahasa target — Inggris, Spanyol, Prancis, Jerman, Portugis, Rusia, Mandarin, Italia, Turki, Vietnam, dan 20+ lainnya.
• Satu penyedia terjemahan. Google Translate gratis langsung bekerja; DeepL punya tier gratis; OpenAI, Anthropic, model lokal (Ollama / LM Studio), dan API apa pun yang kompatibel dengan OpenAI memakai kunci Anda sendiri. Visual novel padat dialog dan peka nada, jadi sebuah LLM (OpenAI / Anthropic) atau DeepL biasanya membacanya paling baik.

Langkah 1: Buka folder game

Luncurkan RuneTranslate, klik New project, dan arahkan ke direktori game Ren’Py (folder dengan .exe, atau folder game/ di dalamnya). Deteksi engine berjalan otomatis dan mengenali proyek sebagai Ren’Py begitu ia melihat pohon game/.

Cara teks dibaca bergantung pada apa yang dikirim pengembang:

• Game sumber — skrip .rpy lepas di bawah game/. RuneTranslate menguraikannya langsung. Ini kasus ideal.
• Game hanya-terkompilasi — hanya bytecode .rpyc. Sidecar unrpyc bawaan mendekompilasinya kembali menjadi .rpy yang terbaca lebih dulu, lalu menguraikannya seperti biasa.
• Game terarsip — skrip dikemas ke dalam arsip .rpa. RuneTranslate membongkarnya dengan rpatool yang di-vendor dan dipatch ke ruang kerja per-proyek di bawah %APPDATA%/RuneTranslate/renpy-workspace/<projectId>/, mendekompilasi, lalu mengurai. Fork rpatool kami mendeteksi otomatis kunci arsip RPA-x.y yang terobfuskasi dan kustom-vendor, sehingga ia membuka banyak arsip yang ditolak alat upstream.

Folder game asli Anda tidak pernah diubah.

Langkah 2: Bagaimana teks Ren’Py diekstrak

RuneTranslate menarik pernyataan say (dialog), pilihan menu, dan teks UI yang bisa diterjemahkan dari skrip dan mendaftarnya di editor, dikelompokkan per berkas. Markup teks Ren’Py — {b}, {color=#fff}, {w} waits, {i} italics, dan interpolasi variabel gaya [player_name] — disamarkan di balik placeholder numerik [[R#]] sebelum apa pun mencapai penyedia, lalu dipulihkan saat keluar. Mesin tak pernah melihat tag-nya, jadi ia tak bisa merusak, membuang, atau menerjemahkannya.

Langkah 3: Terjemahkan

Pilih penyedia dan jalankan. Untuk visual novel panjang-menengah (~8.000–15.000 baris) pada tier Supporter:

• OpenAI / Anthropic — terbaik untuk suara karakter, lelucon, dan gaya bicara khas; kira-kira beberapa dolar biaya API untuk satu game utuh. Editor menampilkan estimasi token + USD sebelum Anda berkomitmen.
• DeepL — cepat dan bersih untuk narasi; tier gratis mencakup 500 ribu karakter/bulan.
• Google Translate gratis — $0, cocok untuk menu dan baris pendek, lebih lemah pada dialog.

Susun glosarium para pemeran dan istilah berulang Anda lebih dulu agar setiap adegan merender nama identik — lihat Glossary 101. Pada tier gratis terjemahan dibatasi sedikit — kira-kira 2x lebih lambat pada penyedia AI, lebih sedikit pada scraper gratis (konkurensi lebih rendah, batch lebih kecil, jeda singkat di antara batch) — dengan kualitas keluaran yang identik. Tier berbayar berjalan dengan kecepatan penuh dan menambahkan translation memory serta perutean penyedia.

Langkah 4: Tinjau di editor

Setiap baris mendarat di tabel di samping sumbernya — Jepang secara default, atau bahasa apa pun yang Anda atur untuk proyek (Mandarin, Korea, Inggris, dan lainnya). Edit apa pun yang salah dikerjakan mesin secara inline (menyimpan otomatis saat blur atau Ctrl+Enter), pakai find & replace untuk istilah yang Anda ganti nama, atau jalankan AI refiner opsional untuk pemeriksaan pass-kedua sadar-konteks. Karena dialog Ren’Py berbentuk panjang, di sinilah pemolesan terjadi.

Langkah 5: Ekspor build yang bisa dimainkan

Klik Export. RuneTranslate tidak mengandalkan Ren’Py memilih .rpy lepas di tl/ — itu hanya bekerja untuk teks yang dikunci berdasarkan id dialog, yang tak diberikan dengan andal oleh game terkompilasi. Sebaliknya ia meletakkan beberapa berkas ke game/ dan menerapkan terjemahan saat runtime:

• rt_translations.json — peta teks-sumber → terjemahan untuk setiap baris dialog dan menu.
• zzz_runetranslate_language.rpy — kait runtime kecil yang memasang config.say_menu_text_filter. Ia mencocokkan setiap baris yang akan ditampilkan game dengan peta itu dan menukar terjemahan Anda, serta memaksa bahasa aktif game menjadi yang terjemahan sehingga teks layar dan UI mengikuti.
• tl/translated/translation.rpy — hanya menyimpan string UI / layar _() (tombol, menu, tooltip), yang memang diselesaikan Ren’Py dengan andal lewat mekanismenya sendiri.
• Font bawaan plus zzz_runetranslate_font.rpy ketika bahasa target memerlukannya — lihat catatan non-Latin di bawah.

Jalankan .exe game dan ia berjalan dalam bahasa target Anda, dengan skrip dan arsip asli tak tersentuh. Untuk kembali, hapus berkas yang ditambahkan RuneTranslate — rt_translations.json, zzz_runetranslate_language.rpy, font bawaan dan .rpy-nya, serta tl/translated/.

Bahasa non-Latin

Kebanyakan game Ren’Py mengirim font hanya-Latin, sehingga Mandarin, Korea, Jepang, Thai, atau Arab akan tampil sebagai kotak kosong. Ketika Anda menargetkan salah satunya, RuneTranslate menyertakan font yang sesuai (NanumGothic / Noto Sans) dan merutekan setiap font yang dipakai game melalui config.font_replacement_map Ren’Py, sehingga teks terjemahan muncul dengan benar tanpa mengedit aset game itu sendiri.

Keterbatasan yang diketahui

• Arsip RPA-2 / RPA-3 / RPA-3.2 / RPA-4.0 standar dan arsip terobfuskasi-vendor yang umum terbuka otomatis; kontainer yang benar-benar tak standar atau kunci yang dipegang eksternal mungkin tak bisa dibongkar.
• Teks yang menyatu dalam gambar (logo judul, UI gambar tangan, keterangan CG) adalah pekerjaan piksel dan tidak diterjemahkan — di luar cakupan terjemahan mesin.
• Layar yang berat skrip yang membangun string saat runtime dari variabel mungkin perlu pass perbaikan tangan cepat di editor.

Mengapa ini lebih mudah dari cara lama

Rute manual berarti mendekompilasi .rpyc dengan tangan, menjalankan rpatool pada arsip, lalu entah menerjemahkan sumber di tempat (dan merusaknya lagi pada pembaruan game berikutnya) atau menulis blok tl/ dengan tangan baris demi baris — dan tetap berjuang melawan font yang hilang pada bahasa non-Latin. RuneTranslate melakukan rantai dekompilasi + bongkar + ekstrak + kait-runtime dalam beberapa klik, sambil menjaga editor tetap terbuka sehingga Anda mengendalikan kata-katanya.

Lihat halaman engine Ren’Py untuk daftar fitur lengkap, baca panduan visual novel Kirikiri untuk engine VN yang berbeda, atau unduh RuneTranslate dan cobalah pada game sungguhan.