unreal · guides · engine · localization
Cara menerjemahkan game Unreal Engine
Game Unreal mengirim teksnya dalam tabel .locres terkompilasi di dalam kontainer .pak atau IoStore. Berikut cara membacanya, dan mengapa keluarannya adalah pak override mungil alih-alih game yang dibangun ulang.
Sebuah game Unreal Engine tampak seperti hal tersulit di drive Anda untuk diterjemahkan. Tak ada folder data, tak ada berkas skrip, tak ada .json yang bisa Anda buka — hanya sebuah eksekutabel, direktori Content/Paks yang menyimpan satu atau dua berkas .pak raksasa, dan mungkin sepasang kontainer .utoc/.ucas. Kabar baiknya, teks yang sebenarnya Anda inginkan biasanya tidak sengaja disembunyikan di dalam berkas-berkas itu. Unreal punya sistem lokalisasi kelas satu, dan kebanyakan game rilisan memakainya. Tugas Anda adalah menemukan tabelnya, mengganti string-nya, dan menyerahkan sebuah berkas kecil kepada engine yang lebih diprioritaskan daripada aslinya.
Bagian terakhir itulah yang membuat Unreal menyenangkan begitu Anda memahaminya. Anda tidak membangun ulang game 60 GB. Anda menghasilkan arsip override berukuran kilobyte dan menaruhnya di sebelah yang asli.
Satu hal sebelum langkah-langkahnya: dukungan Unreal di RuneTranslate sudah dipastikan bisa dimainkan pada judul UE4 dan UE5 sungguhan, tetapi permukaan formatnya sangat luas dan setiap studio mengemas dengan cara berbeda. Verifikasi build yang diekspor di dalam game sebelum berkomitmen pada run terjemahan panjang.
Apa yang sebenarnya dikirim sebuah game Unreal
Unreal menyimpan teks yang dihadapkan ke pemain di berkas `.locres` — bentuk terkompilasi dari FTextLocalizationResource. Ada satu per culture, ditata pada jalur seperti <Game>/Content/Localization/Game/ja/Game.locres, dengan saudaranya untuk en, zh-Hans, dan apa pun lagi yang dikirim studionya. Game tanpa terjemahan sama sekali pun biasanya tetap punya satu, untuk culture tempat ia ditulis.
Sebuah .locres bukan berkas teks dan bukan daftar kunci/nilai sederhana. Ia adalah tabel biner yang tersusun sebagai namespace, masing-masing menyimpan key, dan setiap key menunjuk ke sebuah string. Pada versi modern, namespace dan key disimpan sebagai hash (CRC32 pada versi 2, CityHash64 atas UTF-16 pada versi 3) alih-alih sebagai nama yang terbaca, dan string-nya sendiri berada di tabel pencarian bersama yang dideduplikasi, lengkap dengan hitungan referensi. Runtime tak pernah mencari sebuah string lewat teks Inggrisnya — ia mencarinya lewat pasangan namespace/key itu, yang dikompilasi ke dalam Blueprint dan C++ game saat build.
Struktur itu menentukan satu-satunya cara aman mengeditnya. RuneTranslate mempertahankan setiap hash namespace, hash key, dan hash string-sumber byte demi byte dan hanya mengubah nilainya, lalu membangun ulang tabel string yang dideduplikasi beserta refcount-nya. Tak ada yang menghitung ulang hash, jadi tak ada yang bisa menghasilkan key yang tak bisa ditemukan game. Terjemahan bebas menjadi lebih panjang atau lebih pendek dari aslinya.
Berkas .locres ini lalu dikemas ke dalam arsip .pak — dikenali dari nilai magic 0x5A6F12E1 pada footer di ujung berkas — atau, pada judul UE5 modern, ke dalam kontainer IoStore .utoc/.ucas.
Periksa cakupannya sebelum Anda menghabiskan satu jam
.locres mencakup UI, menu, pesan sistem, teks tutorial, nama item dan skill, serta subtitle — sebut saja kira-kira 90% teks yang terlihat pada game pada umumnya. Itulah bagian yang dibaca RuneTranslate lebih dulu.
Yang tidak dicakup .locres: teks yang dikompilasi ke dalam DataTable atau dipanggang ke paket `.uasset` hasil cook. Sebagian studio, terutama pada proyek kecil atau yang sangat digerakkan Blueprint, menyimpan dialognya di sana alih-alih di sistem lokalisasi. RuneTranslate membaca itu juga. Ketika sebuah game tak punya .locres sendiri, ia membongkar berkas game dan memindai paket hasil cook untuk mencari teks, yang memakan hitungan menit alih-alih detik pada game besar, dan pada game dengan arsip .pak lepas ia juga menambahkan dialog inline yang terlewat oleh .locres. Satu celah: game UE5 IoStore yang mengirim .locres sendiri hanya mendapat teks .locres.
Layak diketahui sejak awal: cara tercepat memeriksanya adalah menjalankan langkah pembuatan proyek dan melihat apa yang keluar. Beberapa ratus string pendek yang semuanya tampak seperti Continue, Options, Are you sure? berarti UI-nya dilokalkan dan skripnya tidak. Beberapa ribu string termasuk kalimat utuh berarti Anda dalam kondisi bagus.
UE5 IoStore berbeda, dan ekstraksinya ditargetkan
Judul UE5 makin sering mengirim kontainer IoStore alih-alih pak biasa: sebuah direktori .utoc yang dipasangkan dengan blob data .ucas, memakai kompresi Oodle. Pendekatan naif di sini adalah membongkar semuanya, yang pada game 105 GB sama sekali bukan pendekatan.
RuneTranslate menyertakan retoc (berlisensi MIT) dan memintanya mengonversi kontainer itu menjadi pak legacy yang disaring hanya ke berkas lokalisasi — setara dengan to-legacy -f locres --no-shaders --no-script-objects. Judul IoStore 105 GB menyusut menjadi beberapa kilobyte .locres, dalam hitungan detik alih-alih jam. retoc juga menangani kompresi Oodle milik kontainer itu sendiri, yang membuat game IoStore melewati masalah Oodle yang bisa dialami pak lepas.
Bagian pentingnya adalah IoStore hanya merumitkan proses membaca. Proses menulisnya universal, dan itu bagian berikutnya.
Keluarannya adalah pak override, bukan game yang dibangun ulang
Ini bagian yang tak dijelaskan dengan benar oleh panduan pesaing mana pun, dan inilah alasan menerjemahkan Unreal menjadi murah begitu ia bekerja sama sekali.
Unreal memasang berkas pak dalam urutan yang ditentukan, dan arsip mana pun yang namanya berakhiran `_P` dipasang paling akhir. Pemasangan yang belakangan menang. Jadi arsip kecil yang tak berisi apa pun selain .locres modifikasi Anda, pada jalur virtual yang sama dengan yang dipakai game dasar, sekadar menaungi aslinya — manajer lokalisasi memuat milik Anda dan tak pernah melihat yang dikirim game.
- Tanpa penandatanganan ulang. Override membiarkan arsip milik game itu sendiri tak tersentuh, jadi tak ada yang perlu ditandatangani ulang.
- Berkas biasa tanpa kompresi. Override ditulis sebagai pak biasa tanpa kompresi yang dibaca engine secara langsung.
- Tanpa pengemasan ulang game. Arsip dasarnya tak tersentuh. Instalasi 60 GB tetap 60 GB; terjemahan Anda adalah berkas berukuran kilobyte.
- Ia bekerja untuk game IoStore juga.
.locresdibaca lewat sistem berkas pak alih-alih pemuat paket Zen, jadi sebuah_P.paklepas biasa tetap terambil bahkan oleh game UE5 yang seluruh asetnya berada di.utoc/.ucas.
Anda memasangnya dengan menyalin _P.pak yang dihasilkan ke <Game>/Content/Paks/ — folder yang sama tempat yang asli berada. Sebagian game juga memasang subfolder ~mods/, yang bekerja sama baiknya. Menghapus terjemahannya berarti menghapus satu berkas itu, yang membuat pengembalian jadi sepele dan membuatnya aman untuk diuji sejak awal.
Langkah-langkahnya
- Pasang RuneTranslate dari halaman unduh dan masuk. Masuk gratis (Patreon, Google, atau email) diperlukan saat peluncuran pertama; tier gratis membuka setiap engine dan setiap penyedia kecuali RuneLingua — ia membatasi throughput dan menahan satu proyek pada satu waktu.
- Buat proyek baru dan arahkan ke folder akar game — yang berisi eksekutabel dan direktori
<Game>. Deteksi mencariContent/Paksdan magic footer pak, atau.utoc/.ucas. - Biarkan RuneTranslate membuka arsipnya. Sebagian besar game tidak butuh apa-apa dari Anda pada langkah ini.
- Biarkan ekstraksi selesai. Anda mendapat entri
.locresuntuk culture sumber, dikelompokkan per target lokalisasi, siap ditinjau. - Pilih penyedia dan terjemahkan. String UI pendek dan dialog panjang bisa dirutekan ke penyedia berbeda jika Anda ingin mengeluarkan uang hanya di tempat yang penting.
- Tinjau apa yang kembali. String menu adalah tempat terjemahan mesin paling lemah — sebuah
SaveatauLoadtelanjang tak punya konteks, dan tombol dua kata yang kembali sebagai satu kalimat akan meluap dari widget-nya. - Ekspor. RuneTranslate menulis sebuah
_P.pakyang berisi teks terjemahan Anda pada jalur relatif-engine yang benar, plus sebuah README. Untuk beberapa game yang engine-nya tak pernah memuat pak patch, ia juga menulis teksnya sebagai.locreslepas, dan README menjelaskan ke mana berkas itu ditaruh. - Salin berkas itu ke
<Game>/Content/Paks/dan luncurkan game-nya.
Uji setelah langkah 8 dengan segelintir string yang sudah diterjemahkan, sebelum Anda menjalankan seluruh game lewat sebuah penyedia. Jika override-nya akan diabaikan — folder salah, culture salah, penyiapan mount yang tak biasa — Anda ingin mengetahuinya dalam lima menit, bukan setelah membayar untuk 9.000 string.
Placeholder dan rich text
Pemformatan FText Unreal memakai {0}, {1} untuk argumen posisional dan {PlayerName}, {Count} untuk yang bernama, plus markup <RichText> dengan penutup </> untuk gaya inline. Jika sebuah penyedia terjemahan membuang atau merusak salah satunya, game tidak menampilkan kalimat yang sedikit salah — ia menampilkan format string yang rusak, atau argumennya diam-diam lenyap dari barisnya.
RuneTranslate menyamarkan setiap satu darinya menjadi placeholder netral sebelum penyedia melihat string-nya, lalu memulihkannya sesudahnya. Penyedia menerjemahkan di sekitar penanda itu alih-alih menembusnya, sehingga sebuah argumen tak bisa dihapus oleh model yang memutuskan bahwa kurung kurawalnya tampak seperti salah ketik. Jika Anda ingin melangkah lebih jauh dan menahan string tertentu sepenuhnya dari terjemahan, filter pengecualian regex bekerja pada engine mana pun, dan sebuah glosarium menjaga nama diri tetap stabil di seluruh game.
Jebakan aksen, yang merupakan bug encoding dan bukan font
Yang ini layak didokumentasikan tersendiri karena gejalanya menunjuk ke arah yang persis salah. Unreal menserialisasi string dengan awalan panjang: panjang positif berarti satu byte per karakter, panjang negatif berarti UTF-16. Engine memilih bentuk sempit hanya ketika setiap karakternya adalah ASCII 7-bit — pemeriksaannya menolak apa pun di atas 0x7F. Pemuatnya dibangun dengan cara yang sama, jadi jika ia diberi string sempit yang mengandung byte tinggi, ia menggantinya dengan ? harfiah untuk masing-masingnya.
Konsekuensi praktisnya: terjemahan yang mengandung poción mágica yang ditulis dalam bentuk sempit sampai ke pemain sebagai poci?n m?gica. Dan pita yang terdampak adalah U+0080–U+00FF, yang persis merupakan huruf beraksen bahasa Spanyol, Prancis, Jerman, Portugis, Italia, dan bahasa-bahasa Nordik. Polandia, Turki, Ceko, Yunani, Sirilik, Jepang, dan Mandarin semuanya berada di atas U+00FF, otomatis mengambil cabang lebar, dan tak pernah terdampak.
Jadi sidik jarinya adalah: aksen rusak dalam bahasa Spanyol tetapi bahasa Rusia baik-baik saja. Jika Anda melihat itu, penyebabnya adalah bug encoding pada apa pun yang menulis berkasnya, bukan glyph yang hilang di font game — glyph yang hilang dirender sebagai kotak atau sebagai ketiadaan, tak pernah sebagai tanda tanya. RuneTranslate punya bug persis ini dan memperbaikinya di 0.49.4; encoder-nya kini berada di satu tempat dan menulis bentuk lebar untuk apa pun di luar ASCII. Ini layak diketahui karena alat lain di bidang ini masih salah menanganinya.
Memilih penyedia
Lima dari dua belas penyedia sama sekali tak butuh kunci API (Google, DeepL gratis, model Classic/Next-gen DeepL, Yandex Translate, dan Gemini Nano yang berjalan di PC Anda sendiri lewat Chrome), dan tier gratis memberi Anda semuanya. Untuk game yang sebagian besar UI, penyedia gratis sungguh cukup. Untuk judul yang padat dialog, penyedia LLM menangani konteks jauh lebih baik; OpenAI, Anthropic, DeepSeek, endpoint apa pun yang kompatibel dengan OpenAI, dan model lokal lewat Ollama atau LM Studio semuanya tersedia, dan paket berbayar juga menyertakan RuneLingua, penerjemah buatan kami sendiri, tanpa perlu pengaturan apa pun. Perbandingan penyedia menuntun Anda melalui kelebihan dan kekurangan masing-masing, dengan angka biaya sungguhan.
Pemecahan masalah
Game berjalan tetapi tak ada yang diterjemahkan
Hampir selalu salah satu dari tiga hal. Berkasnya tidak berada di <Game>/Content/Paks/ — menaruhnya di sebelah eksekutabel tak melakukan apa-apa. Nama berkasnya kehilangan akhiran _P, dan dalam kasus itu ia dipasang dalam urutan alfabet biasa sehingga pak dasar bisa menang. Atau game berjalan dalam culture yang tidak Anda terjemahkan: ia memuat .locres untuk culture apa pun yang diselesaikannya saat mulai, jadi game yang memaksa en akan mengabaikan override yang hanya ditulis untuk ja. Periksa pengaturan bahasa game lebih dulu.
Ekstraksi gagal pada pak lepas terkompresi Oodle
Sebuah .pak lepas yang dikompresi dengan Oodle butuh dekompresor yang tak bisa disertakan. Jika game itu juga mengirim kontainer IoStore, jalur retoc menangani Oodle dan Anda aman. Jika hanya pak lepas, ini berhenti total untuk saat ini, dilaporkan secara eksplisit alih-alih sebagai hasil kosong yang senyap.
Game tak punya .locres di mana pun
Berarti teksnya dikompilasi ke dalam aset hasil cook, dan RuneTranslate membacanya dari sana: ia membongkar berkas game dan memindai paket hasil cook untuk mencari teks, yang bisa memakan beberapa menit pada game besar. Jika itu pun tak menemukan apa-apa, RuneTranslate mengatakannya secara eksplisit alih-alih menyerahkan proyek kosong kepada Anda.
Deteksi sama sekali tidak menyala
Arahkan ke folder yang berisi eksekutabel, bukan ke Content/Paks itu sendiri dan bukan ke folder induk yang penuh game lain. Jika ia tetap tak terdeteksi, pengemasannya tak biasa dan layak dilaporkan — format pak punya tata letak footer yang khas per versi, dan dialek yang belum pernah dilihat siapa pun persis jenis hal yang akan ditambahkan.
Keterbatasan yang jujur
Dukungan Unreal sudah dipastikan bisa dimainkan di dalam game pada judul UE4 dan UE5, lewat .locres di dalam arsip .pak dan IoStore UE5 serta lewat teks yang dibaca dari aset hasil cook. Game UE5 IoStore yang mengirim .locres sendiri hanya mendapat teks itu, bukan dialog aset hasil cook di sebelahnya. Pak lepas terkompresi Oodle tanpa pendamping IoStore tidak didukung. Pak yang penandatanganannya ditegakkan tak bisa di-override, meski itu jarang dalam praktik. Dan karena formatnya sangat bervariasi antar versi engine dan antar studio, perlakukan ekspor pertama sebagai uji coba, bukan sebagai hasil akhir.
Yang Anda dapatkan pada akhirnya adalah build terjemahan yang bisa dimainkan dan Anda simpan di mesin Anda sendiri: game aslinya tak tersentuh, plus satu berkas kecil yang bisa Anda hapus untuk membatalkan semuanya. Jika Anda sedang membandingkan engine atau memeriksa apakah game Anda tercakup sama sekali, halaman engine Unreal memuat detail teknisnya dan semua engine mendaftar kedelapan belas format yang didukung, termasuk Unity dan RPG Maker. Jika Anda baru pada seluruh prosesnya, mulailah dengan panduan umum dan kembalilah ke sini untuk bagian khusus Unreal-nya.
Bacaan terkait
Siap mencoba RuneTranslate?
Tier gratis membuka setiap engine + setiap penyedia terjemahan kecuali RuneLingua. Supporter ($3.99/mo) membuka kecepatan penuh.
Unduh untuk Windows, Mac & Linux
