Cara menerjemahkan game RPG Maker

RPG Maker adalah engine yang paling mungkin Anda temui saat mencari game indie Jepang, dan ia juga yang paling ramah untuk diterjemahkan. Teks game tidak dikompilasi ke dalam eksekutabel — ia berada di berkas data JSON biasa atau data terserialisasi Ruby yang dikirim di sebelah game. Itulah sebabnya terjemahan RPG Maker bisa berjalan sama sekali, dan sebabnya proses di bawah berakhir dengan build yang sungguh bisa Anda mainkan alih-alih overlay yang menebak-nebak apa yang ada di layar.

Panduan ini mencakup cara mengenali RPG Maker mana yang Anda punya, alur ekspornya, apa persisnya yang diterjemahkan, bagaimana kode kontrol bertahan melewati penerjemah mesin, dan apa yang harus dilakukan ketika sebuah baris kembali salah. Ia ditulis agar berguna baik Anda memakai RuneTranslate untuk melakukannya maupun tidak.

RPG Maker mana yang saya punya?

Kebanyakan orang yang menanyakan ini tidak tahu versi mana yang sedang mereka pegang, dan jawabannya mengubah apa yang mungkin dilakukan. Buka folder game dan cari hal pertama dalam daftar ini yang cocok:

• Folder `www/` yang berisi www/data/*.json — RPG Maker MV. Game-nya adalah aplikasi nw.js; eksekutabelnya biasanya Game.exe di sebelah www/.
• Folder `data/` telanjang berisi berkas .json tanpa www/ — RPG Maker MZ. MZ memindahkan semuanya naik satu tingkat, yang merupakan cara tercepat membedakan keduanya.
• `Data/` yang menyimpan .rxdata, .rvdata, atau .rvdata2 — berturut-turut RPG Maker XP, VX, dan VX Ace. Jika Data/ tampak kosong, periksa akar folder untuk Game.rgssad, Game.rgss2a, atau Game.rgss3a; itu data yang sama di dalam arsip terenkripsi.
• `RPG_RT.exe` di akar folder, dengan berkas .lmt dan .lmu — RPG Maker 2000 atau 2003. Generasi engine yang sepenuhnya berbeda.
• Sebuah .exe berukuran puluhan atau ratusan megabyte tanpa www/ atau data/ di sebelahnya — kemungkinan build Enigma Virtual Box dengan datanya dikemas di dalam eksekutabel. Lihat di bawah.

MV dan MZ cukup mirip sehingga orang terus-menerus tertukar, dan keduanya berbeda dalam hal yang penting begitu Anda mulai mengedit. Perbandingan MV vs MZ membahas tata letak folder, format plugin, dan perbedaan kotak pesannya.

Teks game RPG Maker 2000 dan 2003 tidak didukung. RuneTranslate membaca berkas simpanan .lsd mereka lewat save editor dan tidak lebih. Jika Anda punya game RPG_RT.exe dan ingin menerjemahkan skripnya, alat yang tepat adalah EasyRPG, bukan yang ini. Lebih baik Anda meninggalkan halaman ini sekarang daripada menghabiskan satu jam untuk mengetahuinya dengan cara yang sulit.

Alur empat langkah

1. Arahkan New Project ke folder game. Pilih folder yang berisi Game.exe. Engine dideteksi dari apa yang ada di dalamnya — Anda tidak memilih MV atau MZ dari dropdown, dan jika deteksi tak sepakat dengan dugaan Anda, itu layak dibaca sebagai informasi.
2. Pilih penyedia dan bahasa target. Sembilan penyedia tersedia dan tiga di antaranya sama sekali tak butuh kunci API atau akun.
3. Terjemahkan. Runner membagi unit menjadi batch, mengulang kegagalan dengan backoff, dan menampilkan bilah kemajuan sungguhan beserta ETA. Anda bisa mengedit baris mana pun di tabel selagi ia berjalan maupun setelah ia selesai.
4. Ekspor build yang bisa dimainkan ke folder pilihan Anda. Yang mendarat di sana adalah salinan game yang utuh dan bisa dijalankan dengan berkas data terjemahan sudah terpasang.

Folder game asli tidak pernah diubah. Setiap penulisan menuju folder keluaran yang Anda pilih, yang berarti ekspor yang buruk tak memakan biaya apa pun selain ruang disk — hapus dan ekspor lagi. Itu juga berarti Anda bisa menyimpan build Jepang tetap terpasang dan bisa dimainkan berdampingan.

RuneTranslate berjalan di Windows 10 dan 11, serta di Linux dan Steam Deck lewat Wine atau Proton. Login Patreon gratis diperlukan saat peluncuran pertama. Tier gratis membuka setiap engine dan setiap penyedia — ia membatasi throughput dan menahan satu proyek pada satu waktu alih-alih mengunci fitur di balik paywall.

Apa yang sebenarnya diterjemahkan

Untuk MV dan MZ, pengekstrak menelusuri setiap berkas map dan setiap daftar perintah event, lalu menarik perintah yang menghasilkan teks yang terlihat pemain:

• `401` Show Text — baris dialog. Ini adalah bagian terbesar dari game RPG Maker mana pun.
• `405` Show Scrolling Text — intro, kredit, surat, dan narasi bergulir.
• `102` Show Choices — entri jendela pilihan. Label cabang When [choice] dirender dari array yang sama, jadi menerjemahkan pilihannya menerjemahkan keduanya.
• `320` / `324` / `325` — Change Actor Name, Nickname, dan Profile, yang dipakai game untuk pengungkapan dan perubahan wujud di tengah cerita.
• Basis datanya — Actors.json (nama, julukan, profil), Classes.json, Skills.json (nama, deskripsi, serta baris pertarungan message1 / message2), Items.json, Weapons.json, Armors.json, Enemies.json, States.json.
• `System.json` — judul game, satuan mata uang, dan seluruh tabel terms: setiap label menu, nama perintah, dan string status dasar yang digambar engine.
• Nama map di `MapInfos.json` dan CommonEvents.json — common event membawa skrip yang mengejutkan banyaknya pada game yang merutekan dialog lewat satu handler bersama.
• Parameter plugin di plugins.js, dan argumen plugin command MZ (kode perintah 357). Di sinilah banyak game MV/MZ modern menyimpan teks menunya.

Komentar event (108 dan baris lanjutan 408-nya) adalah catatan pengembang yang tak ditampilkan engine kepada pemain, jadi ia dikecualikan secara bawaan. Ia tidak dihapus — ia muncul sebagai baris opt-in yang bisa Anda centang, karena segelintir plugin balon dan pesan popup memang merendernya. Perlakuan yang sama berlaku untuk apa pun yang dibaca pengklasifikasi sebagai pengenal kode atau jalur berkas: dikecualikan, terlihat, bisa dibalik.

Kode kontrol, dan mengapa ia merusak terjemahan

Dialog RPG Maker bukan teks biasa. Ia membawa kode escape inline yang diperluas engine saat menggambar:

• \C[1] — mengganti warna teks ke indeks palet 1.
• \N[2] — menyisipkan nama aktor 2.
• \V[3] — menyisipkan nilai variabel 3.
• \G — satuan mata uang.
• \I[123] — menggambar ikon 123 secara inline.
• \. \| \! \{ \} — jeda sesaat, jeda sedetik, tunggu masukan, perbesar font, perkecil font.

Serahkan salah satunya mentah-mentah ke penerjemah mesin dan Anda akan menerimanya kembali dalam keadaan rusak. Google Translate mengubah urutannya. Model lokal kecil menghilangkan satu kurung, mengecilkan hurufnya, atau mengganti kurung ASCII dengan kurung lebar-penuh. Sebuah LLM sesekali memutuskan bahwa \C[1] adalah salah ketik dan dengan penuh niat baik membuangnya. Hasilnya di dalam game adalah kotak teks yang mencetak backslash mentah, kehilangan warnanya di tengah jalan, atau menampilkan ruang kosong di tempat nama karakter seharusnya berada.

RuneTranslate menyamarkan setiap kode menjadi placeholder bernomor — [[T0]], [[T1]] — sebelum penyedia melihat string-nya sama sekali, lalu memulihkannya dari peta itu sesudahnya. Pemulihannya sengaja dibuat toleran: ia menerima placeholder yang kembali dengan kurung hilang di satu sisi, spasi tambahan di dalamnya, huruf kecil, atau kurung lebar-penuh, karena dalam praktik keempatnya terjadi. Jika sebuah kode hilang sepenuhnya, unit-nya ditandai alih-alih diam-diam dikirim.

Dua kasus yang kurang kentara ditangani mekanisme yang sama. RPG Maker juga memakai substitusi gaya printf — %1 dan %2 di Terms dan di pesan pertarungan skill, seperti pada %1の攻撃！ di mana %1 menjadi nama aktornya — dan itu ikut disamarkan, karena penyedia yang lemah akan mengarang sampah kurung di tempatnya. Banyak game juga mengirim plugin substitusi nama yang memakai token berkurung telanjang seperti [名前] atau [呼名] yang ditukar engine dengan nama pemain saat runtime; itu ikut disamarkan, cukup sempit sehingga prosa berkurung biasa dibiarkan.

Kode multi-huruf yang didefinisikan plugin seperti \FFF[20] atau \FH[ON] cocok dengan pola yang sama dan terlindungi tanpa konfigurasi per-plugin apa pun.

Bungkus baris pada 46 karakter

Bahasa Jepang memuat jauh lebih banyak makna per karakter daripada bahasa Inggris. Baris yang mengisi kotak pesan dengan nyaman dalam bahasa Jepang akan melewati tepi kanan begitu diterjemahkan, dan RPG Maker tidak membungkus baris untuk Anda — ia sekadar menggambar melewati jendelanya dan luapannya tak terlihat. Anda tak akan menyadarinya sampai seorang pemain memberi tahu bahwa separuh kalimat hilang.

Saat ekspor, dialog pada perintah 401 dan 405 dibungkus pada 46 karakter per baris, kira-kira sebanyak yang ditampung jendela pesan bawaan pada ukuran font bawaan. Pemenggalan disisipkan di batas kata, dan baris baru yang sudah ada di sumber dipertahankan, sehingga pemenggalan halaman dan pembagian baris yang disengaja penulisnya tetap bertahan. Game dengan sistem pesan kustom atau font lebih kecil mungkin menginginkan angka lain; game yang menggambar teks di jendela lebih lebar sekadar akan membungkus lebih awal dari yang diperlukan, yang sifatnya kosmetik, bukan rusak.

Gambar dan arsip terenkripsi

MV dan MZ mengirim opsi enkripsi aset yang mengubah nama gambar menjadi .rpgmvp atau .png_ dan mem-XOR sebuah header di atasnya. RuneTranslate tidak mengasumsikan skema standar — ia memulihkan panjang header, panjang jalur XOR, dan kuncinya dari byte berkas itu sendiri, memakai tanda tangan PNG sebagai plaintext yang diketahui dan CRC32 IHDR sebagai pemeriksanya. Itu penting karena ada plugin enkripsi yang memakai parameter berbeda (header 32 byte, jalur 32 byte, kunci yang dicerminkan) dan karena banyak game kuncinya sudah dicabut dari System.json. Skema RPG Maker sendiri tervalidasi pada iterasi pertama, jadi tak ada yang melambat untuk kasus umum, dan apa pun yang ditulis kembali dienkripsi ulang dengan skema yang sama sehingga dekriptor milik game itu sendiri tetap memuatnya.

Untuk XP, VX, dan VX Ace, arsip .rgssad / .rgss2a / .rgss3a dibaca langsung dan data Ruby Marshal di dalamnya diurai dalam TypeScript — tanpa instalasi Ruby, tanpa pembongkar eksternal. Dukungan di sana sebisa mungkin: game XP dan VX menyimpan teks sebagai string byte Shift-JIS alih-alih UTF-8 bertag, yang membuat kasus tepi encoding lebih mungkin terjadi dibanding pada MZ.

Teks yang dilukis ke dalam karya seni — layar judul, tombol menu, papan tanda di sebuah CG — tidak ada di berkas data mana pun dan tak ada pengekstrak yang bisa menjangkaunya. Untuk itulah Image Studio ada: mendeteksi area teks, membersihkan platnya, menata penggantinya, dan memanggangnya kembali ke format gambar milik game itu sendiri, enkripsi termasuk.

Game yang dikemas Enigma Virtual Box

Cukup banyak game RPG Maker yang beredar sama sekali tak punya folder www/ atau data/ yang terlihat, karena seluruh sistem berkas virtualnya dikemas ke dalam eksekutabel dengan Enigma Virtual Box. Petunjuknya adalah penanda EVB\0 di dalam exe dan folder game yang tampak mencurigakan kosongnya.

Ini terdeteksi dan ditangani. Sistem berkas yang dikemas itu dibongkar ke ruang kerja per-proyek, datanya diekstrak dan diterjemahkan seperti biasa, dan saat ekspor seluruh sistem berkas virtual ditulis keluar sebagai folder yang bisa dijalankan — eksekutabel dalam yang dipulihkan, DLL-nya, dan www/ — dengan data terjemahan sudah ditambalkan. Anda menjalankan eksekutabel dalam yang telah diekstrak itu, yang pada titik itu adalah game biasa tanpa kemasan yang membaca berkas data lepas.

Memang harus begitu caranya. Pendekatan sebelumnya menaruh www/ terjemahan di sebelah eksekutabel yang dikemas dan itu diam-diam tak melakukan apa-apa: pembungkus yang sedang berjalan menyelesaikan www/ dari sistem berkas virtual yang tertanam di dalamnya sendiri dan mengabaikan berkas di disk. Jika Anda melakukan ini dengan tangan memakai alat lain, di situlah jebakannya — terjemahannya tampak diterapkan dan game tetap memuat teks aslinya.

Penyedia mana yang harus dipilih

Sembilan penyedia didukung, dan tiga di antaranya tak butuh kunci API maupun akun di mana pun: Google, endpoint DeepL gratis, dan DeepL dengan pilihan model Classic atau Next-gen. Anda bisa menerjemahkan satu game RPG Maker utuh tanpa membayar siapa pun atau mendaftar apa pun. Opsi berbayarnya adalah API DeepL, OpenAI, Anthropic Claude, DeepSeek, endpoint apa pun yang kompatibel dengan OpenAI, dan model lokal lewat Ollama atau LM Studio jika Anda lebih suka tak ada apa pun yang meninggalkan mesin Anda.

Versi ringkasnya khusus untuk RPG Maker: scraper gratis cukup untuk menu, nama item, dan baris pendek, dan itulah yang seharusnya dipakai kebanyakan orang untuk memulai. Mereka kesulitan pada onomatope — jika sebuah penyedia mengembalikan sumbernya tanpa perubahan, unit-nya ditandai gagal beserta catatan alih-alih diam-diam meloloskan bahasa Jepang ke ekspor Anda. Sebuah LLM terasa jauh lebih baik pada dialog panjang, pada nada, dan pada apa pun yang register penuturnya penting. Perbandingan penyedia memuat trade-off sesungguhnya, dan AI refiner membahas menjalankan pass kedua di atas terjemahan yang sudah jadi untuk merapikannya.

Menjaga nama tetap konsisten

Keluhan paling umum tentang game RPG Maker hasil terjemahan mesin adalah protagonisnya dipanggil dengan empat nama berbeda. Glosarium memperbaikinya — patok bacaan yang Anda inginkan untuk setiap karakter, tempat, item, dan skill sebelum menjalankan, dan setiap batch memakainya. Panduan glosarium menuntun Anda membangunnya. Translation memory membantu ke arah yang sama: string sumber yang identik mendapat terjemahan identik di seluruh proyek, yang penting pada engine di mana deskripsi item yang sama muncul di toko, di menu, dan di event peti.

Satu jebakan khas RPG Maker: sebagian plugin berpatokan pada string nama penuturnya dengan kesetaraan persis — keluarga TRP Skit untuk MZ adalah yang paling dikenal. Terjemahkan namanya di Actors.json dan biarkan yang di data plugin, maka pencocokannya gagal diam-diam, sehingga potret atau skit-nya tak pernah tampil. RuneTranslate menyinkronkan kedua sisi saat ekspor. Jika Anda mengedit dengan tangan, ingat bahwa sebuah nama di RPG Maker bisa sekaligus menjadi teks tampilan dan kunci pencarian.

Ketika ada yang salah

Sebuah baris masih berbahasa Jepang

Tiga penyebab lazim. Ia tak pernah diekstrak, karena ia berada di tempat yang tak ditelusuri pengekstrak — berkas data milik plugin kustom, atau teks yang dipanggang ke dalam gambar. Ia diekstrak tetapi dikecualikan, karena pengklasifikasi membacanya sebagai pengenal; cari ia sebagai baris opt-in dan centang. Atau penyedia mengembalikan sumbernya tanpa perubahan, yang tampil sebagai unit gagal yang bisa Anda jalankan ulang pada penyedia lain. Jika Anda menerjemahkan game itu sebelum memperbarui aplikasinya, pakai Re-scan source dari menu ⋯ editor — pemindaian ulang hanya menambah unit, ia tak pernah menghapus terjemahan Anda yang sudah ada.

Teks meluap dari kotak pesan

Pembungkusan bawaan menyasar jendela bawaan. Game dengan sistem pesan kustom, font lebih besar, atau potret yang memakan separuh kotak akan butuh baris lebih pendek. Edit unit yang bermasalah langsung dan sisipkan pemenggalan baris Anda sendiri — pemenggalan manual dipertahankan melewati ekspor. Ini juga solusinya ketika sebuah terjemahan memang terlalu bertele-tele: tulis ulang lebih pendek alih-alih melawan pembungkusnya.

Game tak mau mulai setelah ekspor

Hampir selalu berkas data yang rusak, bukan teks yang buruk. Pastikan Anda meluncurkan eksekutabel di folder keluaran, bukan yang asli. Pada build EVB, pastikan Anda menjalankan eksekutabel dalam yang telah diekstrak. Jika sebuah event tertentu membuat crash, tersangkanya adalah kode kontrol yang tak bertahan — buka unit itu dan bandingkan kodenya dengan sumbernya. Jaga folder game asli tetap tak tersentuh agar Anda selalu punya baseline yang bekerja untuk dibandingkan.

Sebuah string plugin tidak boleh diterjemahkan

Parameter plugin mencampur teks tampilan dengan nama switch, jalur berkas, pengaturan tombol, dan flag mode di blok yang sama. Apa pun yang terbaca sebagai pengenal kode atau jalur dikecualikan otomatis, tetapi plugin yang memakai kata Jepang sebagai kunci internal akan lolos. Tandai unit itu sebagai dikecualikan dan ia tetap dalam bahasa sumber saat ekspor. Filter regex melakukan ini secara massal ketika parameter sebuah plugin berbagi pola penamaan.

Keterbatasan yang jujur

• Teks game RPG Maker 2000 / 2003 di luar cakupan. Hanya berkas simpanan, lewat save editor. Pakai EasyRPG untuk skripnya.
• XP, VX, dan VX Ace sebisa mungkin. Pembaca arsip dan pengurai Ruby Marshal-nya TypeScript murni dan bekerja, tetapi penanganan string Shift-JIS yang lebih tua adalah permukaan yang lebih kasar dibanding MV/MZ.
• Teks yang dikompilasi ke dalam JavaScript plugin kustom hanya terjangkau ketika ia tampak seperti data. Plugin yang menuliskan string keras di dalam logikanya sendiri adalah pekerjaan edit manual.
• Build MZ yang terproteksi secara native — di mana datanya didekripsi di bawah lapisan JavaScript — ditangani lewat jalur penangkapan runtime dan overlay alih-alih dengan membalik enkripsinya. Ia bekerja; perlakukan sebagai sebisa mungkin dan verifikasi ekspornya sebelum berkomitmen pada run panjang.
• Tidak ada di sini yang menggantikan memainkan build-nya. Jumlah ekstraksi dan bilah kemajuan hijau bukan bukti. Luncurkan game yang diekspor dan baca sepuluh menit pertamanya.

Dua hal berdekatan yang layak diketahui

Cheat Mode membaca switch, variabel, dan item milik game RPG Maker sendiri dan membiarkan Anda mengubahnya, yang merupakan cara tercepat mencapai event akhir-permainan yang terjemahannya perlu Anda periksa — dan begitulah kebanyakan orang memverifikasi sebuah ekspor tanpa mengulang dua puluh jam permainan. Save editor membuka simpanan MV/MZ, XP/VX/VX Ace, dan .lsd 2000/2003 secara langsung, sehingga playthrough yang macet atau item kunci yang hilang tak mengakhiri sebuah run.

Jika Anda ingin gambaran yang lebih luas lebih dulu, daftar engine mencakup ketujuh belas format yang didukung, halaman engine RPG Maker memuat detail formatnya, dan panduan umum adalah versi panduan ini yang tidak khusus-engine. Ketika Anda siap, halaman unduh menyediakan installer-nya.