Cách dịch game Ren’Py sang tiếng Anh (hướng dẫn đầy đủ)

Ren’Py là engine dựa trên Python đứng sau phần lớn visual novel phương Tây và Nhật, từ các game jam nhỏ trên itch.io tới các tựa thương mại trên Steam. Đây là một trong những engine dễ dịch nhất: RuneTranslate không bao giờ ghi đè script gốc, mà phủ bản dịch lên trên để game vẫn nguyên vẹn. Hướng dẫn này đi qua toàn bộ quy trình dịch một game Ren’Py sang tiếng Anh (hoặc bất kỳ ngôn ngữ nào) bằng RuneTranslate, gồm ba dạng một game Ren’Py có thể được phát hành: .rpy nguồn rời, .rpyc chỉ có bản biên dịch, và .rpa đóng gói.

Bạn cần gì

• RuneTranslate cho Windows hoặc Linux: miễn phí, mở khóa mọi engine và mọi nhà cung cấp trừ RuneLingua.
• Một thư mục game Ren’Py. Đó là thư mục chứa file .exe của game cùng thư mục con game/ (nơi có các file .rpy, .rpyc và / hoặc .rpa).
• Một ngôn ngữ đích: tiếng Anh, Tây Ban Nha, Pháp, Đức, Bồ Đào Nha, Nga, Trung, Ý, Thổ Nhĩ Kỳ, Việt và hơn 20 ngôn ngữ nữa.
• Một nhà cung cấp dịch. Google Translate miễn phí dùng được ngay; DeepL có bậc miễn phí; OpenAI, Anthropic, mô hình cục bộ (Ollama / LM Studio) và mọi API tương thích OpenAI đều dùng khóa của bạn. Visual novel nhiều hội thoại và nhạy giọng điệu, nên một LLM (OpenAI / Anthropic) hoặc DeepL thường đọc hay nhất.

Bước 1: Mở thư mục game

Mở RuneTranslate, bấm Dự án mới, rồi trỏ tới thư mục game Ren’Py (thư mục có file .exe, hoặc thư mục game/ bên trong). Việc phát hiện engine chạy tự động và nhận ra dự án là Ren’Py ngay khi thấy cây game/.

Cách đọc văn bản phụ thuộc vào thứ nhà phát triển đã phát hành:

• Game có mã nguồn: các script .rpy rời trong game/. RuneTranslate đọc trực tiếp. Đây là trường hợp lý tưởng.
• Game chỉ có bản biên dịch: chỉ có bytecode .rpyc. Một sidecar unrpyc đi kèm sẽ giải ngược chúng về .rpy đọc được trước, rồi phân tích như bình thường.
• Game đóng gói: script nằm trong một kho lưu .rpa. RuneTranslate giải nén nó bằng rpatool đã vá, đi kèm sẵn, vào một không gian làm việc riêng của dự án tại %APPDATA%/RuneTranslate/renpy-workspace/<projectId>/, giải ngược, rồi phân tích. Bản fork rpatool của chúng tôi nhận ra các biến thể kho lưu RPA-x.y tùy biến của nhà phát hành, nên mở được nhiều kho mà công cụ gốc không mở nổi.

Thư mục game gốc của bạn không bao giờ bị chỉnh sửa.

Bước 2: Văn bản Ren’Py được trích xuất thế nào

RuneTranslate lấy các câu lệnh say (hội thoại), lựa chọn menu và văn bản giao diện dịch được ra khỏi script, rồi liệt kê trong trình chỉnh sửa, nhóm theo file. Mã đánh dấu văn bản của Ren’Py, gồm {b}, {color=#fff}, {w} (chờ), {i} (nghiêng) và nội suy biến kiểu [player_name], được che sau các placeholder số [[R#]] trước khi bất cứ thứ gì tới nhà cung cấp, rồi được khôi phục khi trả về. Máy không bao giờ thấy các thẻ, nên không thể làm hỏng, bỏ sót hay dịch chúng.

Bước 3: Dịch

Chọn nhà cung cấp và chạy. Với một visual novel cỡ vừa (~8,000-15,000 dòng) ở gói Supporter:

• OpenAI / Anthropic: tốt nhất cho giọng nhân vật, câu đùa và lối nói cách điệu; chi phí API khoảng vài đô cho cả game. Trình chỉnh sửa hiển thị ước tính token + USD trước khi bạn xác nhận.
• DeepL: nhanh và sạch cho phần dẫn truyện; bậc miễn phí cho 500k ký tự/tháng.
• Google Translate miễn phí: $0, ổn cho menu và dòng ngắn, yếu hơn ở hội thoại.

Hãy lập bảng thuật ngữ cho dàn nhân vật và các thuật ngữ lặp lại ngay từ đầu để mọi cảnh dịch tên giống nhau, xem Bảng thuật ngữ 101. Ở gói Miễn phí, việc dịch bị giới hạn tốc độ nhẹ, chậm hơn khoảng 2 lần với nhà cung cấp AI và ít hơn với nhà cung cấp miễn phí (đồng thời thấp hơn, lô nhỏ hơn, nghỉ ngắn giữa các lô), với chất lượng đầu ra y hệt. Các gói trả phí chạy ở tốc độ tối đa và thêm bộ nhớ dịch cùng định tuyến nhà cung cấp.

Bước 4: Xem lại trong trình chỉnh sửa

Mỗi dòng nằm trong bảng cạnh văn bản gốc, mặc định là tiếng Nhật, hoặc ngôn ngữ nào bạn đặt cho dự án (Trung, Hàn, Anh và nhiều ngôn ngữ khác). Sửa trực tiếp bất cứ chỗ nào máy dịch sai (tự lưu khi rời ô hoặc Ctrl+Enter), dùng Tìm & Thay thế cho thuật ngữ bạn đã đổi tên, hoặc chạy bộ tinh chỉnh AI tùy chọn để đọc soát lượt hai có ngữ cảnh. Vì hội thoại Ren’Py dài, đây là nơi bạn trau chuốt.

Bước 5: Xuất bản dựng chơi được

Bấm Xuất. RuneTranslate không dựa vào việc Ren’Py ưu tiên file .rpy rời trong tl/, vì cách đó chỉ chạy với văn bản được khóa theo id hội thoại, thứ mà game đã biên dịch không cấp ổn định. Thay vào đó, nó đặt vài file vào game/ và áp dụng bản dịch lúc chạy:

• rt_translations.json: bản đồ văn bản nguồn → bản dịch cho mọi dòng hội thoại và menu.
• zzz_runetranslate_language.rpy: một hook runtime nhỏ cài config.say_menu_text_filter. Nó đối chiếu từng dòng game sắp hiển thị với bản đồ rồi thay bản dịch của bạn vào, và ép ngôn ngữ đang dùng của game sang ngôn ngữ đã dịch để văn bản màn hình và giao diện cũng theo.
• tl/translated/translation.rpy: một bảng chuỗi chứa mọi bản dịch, thứ mà các chuỗi giao diện / màn hình _() (nút, menu, tooltip) tra cứu qua.
• Một phông chữ đi kèm cùng zzz_runetranslate_font.rpy khi ngôn ngữ đích cần, xem ghi chú non-Latin bên dưới.

Chạy file .exe của game và nó chạy bằng ngôn ngữ đích của bạn, còn script và kho lưu gốc không bị đụng tới. Để quay lại bản cũ, xóa các file RuneTranslate đã thêm: rt_translations.json, zzz_runetranslate_language.rpy, phông chữ đi kèm cùng .rpy của nó, và tl/translated/.

Các ngôn ngữ non-Latin

Phần lớn game Ren’Py chỉ kèm phông chữ Latin, nên tiếng Trung, Hàn, Nhật, Thái hoặc Ả Rập sẽ hiện thành ô trống. Khi bạn dịch sang các ngôn ngữ đó, RuneTranslate đi kèm một phông phù hợp (NanumGothic / Noto Sans) và trỏ các phông chữ của game sang nó (kể cả các nhóm phông chữ mà game tự dựng), để văn bản đã dịch hiển thị đúng mà không phải sửa tài nguyên của game.

Giới hạn đã biết

• Các kho RPA-2 / RPA-3 / RPA-3.2 / RPA-4.0 chuẩn và các kho do nhà phát hành tùy biến phổ biến mở được tự động; một container thực sự không chuẩn có thể không giải nén được.
• Chữ nằm trong ảnh (logo tiêu đề, giao diện vẽ tay, chú thích CG) không nằm trong script; hãy dịch nó trong Studio ảnh, công cụ đọc ảnh từ game/ và từ các kho .rpa rồi ghi ảnh đã dịch ra dạng file rời.
• Văn bản mà game ghép ra lúc chạy (dòng cửa hàng, dòng chỉ số, thông báo) được dịch qua một hook runtime; một màn hình ghép chữ theo cách khác vẫn có thể cần sửa tay nhanh trong trình chỉnh sửa.

Vì sao cách này dễ hơn cách cũ

Cách thủ công nghĩa là giải ngược .rpyc bằng tay, chạy rpatool trên kho lưu, rồi hoặc dịch thẳng vào script (và lại hỏng ở bản cập nhật game kế tiếp) hoặc tự viết từng khối tl/ từng dòng một, mà vẫn phải vật lộn với phông thiếu ở ngôn ngữ non-Latin. RuneTranslate làm cả chuỗi giải ngược + giải nén + trích xuất + hook runtime chỉ vài cú bấm, trong khi vẫn mở trình chỉnh sửa để bạn kiểm soát câu chữ.

Xem trang engine Ren’Py để biết danh sách tính năng đầy đủ, đọc hướng dẫn visual novel Kirikiri cho một engine VN khác, hoặc tải RuneTranslate và thử trên một game thật.