Engine được hỗ trợ · RPG Maker XP / VX / VX Ace
RPG Maker XP, VX và VX Ace là thế hệ Ruby của RPG Maker (RGSS1, RGSS2 và RGSS3), và chúng lưu dữ liệu game theo một định dạng hoàn toàn khác với MV và MZ dựa trên JavaScript. Thay vì JSON đọc được, mọi thứ nằm trong các file nhị phân Ruby Marshal dưới Data/: Map001.rxdata trên XP, .rvdata trên VX, .rvdata2 trên VX Ace, cùng các file cơ sở dữ liệu và System. Một game đã phát hành thường đóng gói các file đó trong archive RGSSAD (Game.rgssad cho XP, Game.rgss2a cho VX, Game.rgss3a cho VX Ace) nằm cạnh file thực thi. RuneTranslate tự xử lý cả hai lớp bằng Rust thuần. Nó đọc thẳng archive, không cần cài Ruby, không cần trình soạn thảo RPG Maker và không cần công cụ giải nén riêng, rồi phân tích dữ liệu Marshal 4.8 bên trong bằng bộ đọc và ghi tự viết, chỉ ghi lại các lá chuỗi: số thực, bảng và mọi thân đối tượng khác được ghi lại từng byte y như cũ, nên file game nạp vẫn có cấu trúc giống hệt file nó phát hành. Từ đó nó lấy hội thoại sự kiện bản đồ (đóng gói trong mã sự kiện 101 trên XP, 401 và 405 trên VX và VX Ace), danh sách Show Choices, tên sự kiện và bản đồ, cơ sở dữ liệu (tên nhân vật, vật phẩm, kỹ năng, vũ khí, giáp, kẻ địch và trạng thái, biệt danh, mô tả và ghi chú), cùng từ vựng System và tên nguyên tố. Mã điều khiển như \C[1], \N[2] và \V[3] được che trước khi văn bản tới nhà cung cấp, và hội thoại được tự xuống dòng khi xuất để vừa khung thông điệp. Một lưu ý nói thẳng: VX Ace chạy Ruby 1.9 và gắn thẻ mã hóa cho mọi chuỗi, nên nó là Unicode từ đầu đến cuối. XP và VX chạy Ruby 1.8 và lưu văn bản không có thẻ mã hóa, nên RuneTranslate tự nhận ra theo từng game đó là Shift-JIS hay UTF-8. Game lưu bằng UTF-8 giữ nguyên mọi chữ cái trong bản dịch của bạn; với game Shift-JIS, những chữ cái mà bảng mã đó không chứa được (dấu, chữ Thái, chữ Ả Rập và tương tự) bị đơn giản hóa hoặc mất, nên đích tiếng Anh và romaji là lựa chọn an toàn nhất ở đó. Thế hệ MV và MZ mới hơn được nói tới ở trang RPG Maker MV / MZ.
Game RPG Maker thời Ruby rất dài và lặp lại cùng các danh từ khắp nơi: tên một kỹ năng viết trong một sự kiện lại xuất hiện trong cơ sở dữ liệu, nhật ký chiến đấu và menu cửa hàng. Hãy thêm tên đồng đội, tên thị trấn, vật phẩm quan trọng và kỹ năng đặc trưng vào bảng thuật ngữ một lần, và mọi nhà cung cấp sẽ dịch chúng giống hệt nhau trong toàn bộ Data/. Điều này quan trọng với XP và VX hơn VX Ace, vì văn bản Shift-JIS của chúng khó giúp bạn nhận ra một cái tên bị trôi đi giữa chừng trong 40 giờ chơi.
Mở thư mục game và nhìn vào Data/. File đuôi .rxdata là RPG Maker XP, .rvdata là VX và .rvdata2 là VX Ace. Nếu không có Data/, hãy tìm cạnh file thực thi xem có Game.rgssad (XP), Game.rgss2a (VX) hoặc Game.rgss3a (VX Ace) không: dữ liệu nằm trong archive đó. Nếu thay vào đó bạn thấy www/data/*.json hoặc data/*.json thì đó là MV hoặc MZ, hãy dùng trang RPG Maker MV / MZ cho chúng.
Mở RuneTranslate, bấm Dự án mới và chọn thư mục chứa file thực thi của game. Việc phát hiện là tự động, cho biết nó tìm thấy phiên bản nào trong ba phiên bản và dữ liệu đang ở dạng rời hay trong archive. Archive RGSSAD được đọc thẳng và các file Data của nó được giải nén vào một không gian làm việc riêng của dự án, không dùng runtime Ruby hay công cụ giải nén ngoài.
Chọn ngôn ngữ đích, rồi chọn nhà cung cấp: Google và các tùy chọn DeepL miễn phí không cần khóa API, DeepL API cho chất lượng cân bằng, còn OpenAI, Anthropic Claude, DeepSeek, bất kỳ endpoint tương thích OpenAI nào hoặc mô hình cục bộ qua Ollama hay LM Studio xử lý hội thoại dài có ngữ cảnh tốt. Ngôn ngữ nguồn mặc định là tiếng Nhật, và bạn có thể đặt bất kỳ ngôn ngữ nguồn được hỗ trợ nào theo từng dự án.
RuneTranslate gửi các chuỗi theo lô tới nhà cung cấp và ghi chúng trở lại vào dự án. Hội thoại bản đồ, lựa chọn, mục cơ sở dữ liệu và thuật ngữ System được nhóm lại để bạn xem lại từng bản đồ hoặc từng bảng cơ sở dữ liệu một, sửa tay bất kỳ dòng nào và thử lại các lô bị lỗi. Mã điều khiển được che xuyên suốt, nên \C[1], \N[2] và \V[3] còn nguyên sau cả quá trình.
Khi xuất, RuneTranslate ghi ra một bản sao đầy đủ chạy được của game với dữ liệu Marshal đã dịch. Với game dùng archive, archive được giải nén thành file rời trong Data/ và bản thân archive bị bỏ đi, đúng cách RGSS nạp một game khi không có archive. Hội thoại được tự xuống dòng khi xuất. Kết quả là một bản dựng đã dịch, chơi được và là của bạn, còn bản gốc không bị đụng tới.
