Desteklenen motor · RPG Maker XP / VX / VX Ace
RPG Maker XP, VX ve VX Ace, RPG Maker'ın Ruby kuşağıdır — RGSS1, RGSS2 ve RGSS3 — ve oyun verilerini JavaScript tabanlı MV ile MZ'den bütünüyle farklı bir biçimde saklarlar. Okunabilir JSON yerine her şey Data/ altındaki Ruby Marshal ikili dosyalarında durur: XP'de Map001.rxdata, VX'te .rvdata, VX Ace'te .rvdata2 — veritabanı dosyaları ve System ile birlikte. Yayımlanmış bir oyun bu dosyaları genellikle yürütülebilir dosyanın yanında duran şifreli bir RGSSAD arşivinin içinde gönderir: Game.rgssad (XP), Game.rgss2a (VX) veya Game.rgss3a (VX Ace). RuneTranslate her iki katmanı da saf TypeScript ile kendisi ele alır. Arşivi doğrudan okur — Ruby kurulumu, RPG Maker düzenleyicisi ya da ayrı bir açma aracı gerekmez — ve içindeki Marshal 4.8 verisini yalnızca dize yapraklarını yeniden yazan kendi okuyucusu ve yazıcısıyla ayrıştırır: kayan sayılar, tablolar ve diğer her nesne gövdesi bayt bayt yeniden yazılır, dolayısıyla oyunun yüklediği dosya yapısal olarak gönderildiği dosyadır. Oradan harita olay diyaloğunu (XP'de olay kodu 101, VX ve VX Ace'te 401 ve 405 içinde paketlenmiş), Seçenekleri Göster listelerini, olay ve harita adlarını, veritabanını — aktör, eşya, yetenek, silah, zırh, düşman ve durum adları, takma adlar, açıklamalar ve notlar — artı System sözcük dağarcığını ve element adlarını çeker. \C[1], \N[2] ve \V[3] gibi kontrol kodları metin bir sağlayıcıya ulaşmadan önce maskelenir ve diyalog, mesaj penceresine sığsın diye dışa aktarımda sözcük kaydırılır. Açıkça söylenen tek bir uyarı: VX Ace Ruby 1.9 çalıştırır ve her dizeyi kodlamasıyla etiketler, dolayısıyla baştan sona Unicode'dur. XP ve VX ise Ruby 1.8 çalıştırır ve metni etiketsiz Shift-JIS bayt dizeleri olarak saklar; bu da onları kodlama uç durumlarına daha açık kılar — orada en güvenli seçim İngilizce ve romaji hedefleridir. Daha yeni MV ve MZ kuşağı RPG Maker MV / MZ sayfasında ele alınıyor.
Ruby dönemi RPG Maker oyunları uzundur ve aynı isimleri her yerde tekrarlar — bir olayda yazılan bir yetenek adı veritabanında, savaş kaydında ve bir dükkân menüsünde yeniden görünür. Grubun adlarını, kasaba adlarını, anahtar eşyaları ve imza yeteneklerini sözlüğe bir kez ekleyin; her sağlayıcı bunları Data/ altındaki her yerde aynı şekilde işlesin. Bu, XP ve VX'te VX Ace'ten daha çok önem taşır, çünkü Shift-JIS metinleri 40 saatlik bir oyunun ortasında kayan bir adı fark etmek için daha az alan bırakır. Sözlük 101 →
Oyun klasörünü açın ve Data/ klasörüne bakın. .rxdata ile biten dosyalar RPG Maker XP, .rvdata VX, .rvdata2 ise VX Ace demektir. Data/ yoksa yürütülebilir dosyanın yanında Game.rgssad (XP), Game.rgss2a (VX) veya Game.rgss3a (VX Ace) arayın — veri o arşivin içindedir. Bunun yerine www/data/*.json ya da data/*.json görüyorsanız elinizde MV veya MZ var; onlar için RPG Maker MV / MZ sayfasını kullanın.
RuneTranslate'i başlatın, Yeni proje'ye tıklayın ve oyunun yürütülebilir dosyasını içeren klasöre yönlendirin. Algılama otomatiktir; üç sürümden hangisini bulduğunu ve verinin gevşek mi arşivlenmiş mi olduğunu bildirir. Şifreli bir RGSSAD doğrudan okunur ve Data dosyaları proje başına bir çalışma alanına çözülür — ne Ruby çalışma zamanı ne de harici bir açıcı devreye girer.
Hedef dilinizi, ardından bir sağlayıcı seçin: Google ve ücretsiz DeepL seçenekleri hiç API anahtarı istemez, DeepL API dengeli kalite verir; OpenAI, Anthropic Claude, DeepSeek, herhangi bir OpenAI uyumlu uç nokta ya da Ollama veya LM Studio üzerinden yerel bir model uzun diyalogu bağlamıyla işler. Kaynak dil varsayılan olarak Japoncadır; desteklenen herhangi bir kaynak proje başına ayarlanabilir.
RuneTranslate dizeleri gruplar hâlinde sağlayıcıya gönderir ve sonuçları projeye geri yazar. Harita diyaloğu, seçimler, veritabanı kayıtları ve System terimleri gruplandırılır, böylece bir haritayı ya da bir veritabanı tablosunu tek seferde gözden geçirebilir, herhangi bir satırı elle düzenleyebilir ve başarısız grupları yeniden deneyebilirsiniz. Kontrol kodları baştan sona maskelenir, dolayısıyla \C[1], \N[2] ve \V[3] gidiş-dönüşten sağlam çıkar.
Dışa aktarma, çevrilmiş Marshal verisi yerinde olacak şekilde oyunun tam çalıştırılabilir bir kopyasını yazar. Arşivlenmiş bir oyunda arşiv, Data/ içine gevşek dosyalar olarak çözülür ve arşivin kendisi bırakılır; RGSS, arşiv yokken bir oyunu böyle yükler. Diyalog çıkışta sözcük kaydırılır. Sonuç, orijinali dokunulmadan kalan, sizde kalacak oynanabilir çevrilmiş bir sürümdür.
