Ren’Py 게임을 영어로 번역하는 방법 (전체 안내)

Ren’Py는 대부분의 서구 및 일본 비주얼 노벨 뒤에 있는 파이썬 기반 엔진입니다 — 작은 itch.io 잼부터 상업용 DLsite 타이틀까지요. 번역하기 가장 깔끔한 엔진 중 하나입니다. RuneTranslate는 원본 스크립트를 절대 덮어쓰지 않고, 그 위에 번역을 겹쳐 게임을 온전하게 유지합니다. 이 가이드는 Ren’Py 게임을 영어(또는 어떤 언어로든)로 처음부터 끝까지 번역하는 과정을 안내하며, Ren’Py 게임이 배포되는 세 가지 형태 — 낱개 .rpy 소스, 컴파일 전용 .rpyc, 아카이브된 .rpa — 를 포함합니다.

필요한 것

• Windows용 RuneTranslate — 무료. 모든 엔진과 제공자가 열려 있습니다.
• Ren’Py 게임 폴더. 게임의 .exe와 (.rpy, .rpyc, .rpa 파일을 담은) game/ 하위 폴더가 있는 디렉터리입니다.
• 대상 언어 — 영어, 스페인어, 프랑스어, 독일어, 포르투갈어, 러시아어, 중국어, 이탈리아어, 터키어, 베트남어, 그 외 20개 이상.
• 번역 제공자 하나. 무료 Google Translate는 바로 작동하고, DeepL은 무료 등급이 있으며, OpenAI, Anthropic, 로컬 모델(Ollama / LM Studio), 모든 OpenAI 호환 API는 직접 키를 준비해야 합니다. 비주얼 노벨은 대사가 많고 어조에 민감하니 보통 LLM(OpenAI / Anthropic)이나 DeepL이 가장 잘 읽힙니다.

1단계: 게임 폴더 열기

RuneTranslate를 실행하고 새 프로젝트를 클릭한 뒤 Ren’Py 게임 디렉터리(.exe가 있는 폴더, 또는 안쪽 game/ 폴더)를 지정하세요. 엔진 감지가 자동으로 실행되어 game/ 트리를 보는 순간 프로젝트를 Ren’Py로 인식합니다.

텍스트가 읽히는 방식은 개발자가 무엇을 배포했느냐에 달려 있습니다:

• 소스 게임 — game/ 아래 낱개 .rpy 스크립트. RuneTranslate가 직접 파싱합니다. 가장 이상적인 경우입니다.
• 컴파일 전용 게임 — .rpyc 바이트코드만. 번들된 unrpyc 사이드카가 먼저 읽을 수 있는 .rpy로 디컴파일한 뒤 평소처럼 파싱합니다.
• 아카이브된 게임 — .rpa 아카이브에 패킹된 스크립트. RuneTranslate가 벤더링·패치된 rpatool로 그것을 %APPDATA%/RuneTranslate/renpy-workspace/<projectId>/ 아래 프로젝트별 작업 공간으로 언팩한 뒤 디컴파일하고 파싱합니다. 우리 rpatool 포크는 난독화된 벤더 커스텀 RPA-x.y 아카이브 키를 자동 감지하므로, 상위 도구가 거부하는 많은 아카이브를 엽니다.

원본 게임 폴더는 절대 수정되지 않습니다.

2단계: Ren’Py 텍스트가 추출되는 방식

RuneTranslate는 스크립트에서 say 문(대사), menu 선택지, 번역 가능한 UI 텍스트를 끄집어내 편집기에 파일별로 묶어 나열합니다. Ren’Py 텍스트 마크업 — {b}, {color=#fff}, {w} 대기, {i} 이탤릭, [player_name] 스타일 변수 삽입 — 은 무언가가 제공자에 닿기 전에 숫자 [[R#]] 플레이스홀더 뒤에 가려졌다가 나갈 때 복원됩니다. 기계는 태그를 절대 보지 못하므로 훼손하거나 떨어뜨리거나 번역할 수 없습니다.

3단계: 번역하기

제공자를 골라 실행하세요. Supporter 등급에서 중간 길이 비주얼 노벨(약 8,000~15,000줄)이라면:

• OpenAI / Anthropic — 캐릭터의 목소리, 농담, 개성 있는 말투에 가장 좋습니다. 게임 하나에 API 비용 대략 몇 달러. 편집기가 커밋 전에 토큰 + USD 견적을 보여줍니다.
• DeepL — 서술에 빠르고 깔끔합니다. 무료 등급이 월 50만 자를 커버합니다.
• 무료 Google Translate — $0, 메뉴와 짧은 줄에 적합하고 대사에는 약합니다.

모든 장면에서 이름이 똑같이 렌더링되도록 등장인물과 반복 용어를 미리 용어집에 넣으세요 — 용어집 101을 참고하세요. 무료 등급에서는 번역이 적당히 조절됩니다 — AI 제공자에서 대략 2배 느리고, 무료 스크레이퍼에서는 그보다 덜(낮은 동시성, 작은 배치, 배치 사이 짧은 멈춤) — 출력 품질은 동일합니다. 유료 등급은 전속력으로 실행되며 번역 메모리와 제공자 라우팅을 추가합니다.

4단계: 편집기에서 검토하기

모든 줄이 원본 옆의 표에 도착합니다 — 기본은 일본어, 또는 프로젝트에 설정한 언어(중국어, 한국어, 영어 등)로요. 기계가 틀린 것은 인라인으로 편집하고(포커스 해제나 Ctrl+Enter에 자동 저장), 이름을 바꾼 용어는 찾기·바꾸기를 쓰거나, 선택적 AI 리파이너로 문맥 인식 2차 교정을 돌리세요. Ren’Py 대사는 장문이라, 여기가 다듬기가 일어나는 곳입니다.

5단계: 실행 가능한 빌드 내보내기

내보내기를 클릭하세요. RuneTranslate는 Ren’Py가 tl/의 낱개 .rpy를 선호하는 것에 의존하지 않습니다 — 그것은 대사 id로 키가 매겨진 텍스트에만 작동하는데, 컴파일된 게임은 그것을 안정적으로 내주지 않습니다. 대신 몇 개의 파일을 game/에 떨구고 런타임에 번역을 적용합니다:

• rt_translations.json — 모든 대사와 메뉴 줄에 대한 원본 텍스트 → 번역 맵.
• zzz_runetranslate_language.rpy — config.say_menu_text_filter를 설치하는 작은 런타임 훅. 게임이 막 표시하려는 각 줄을 맵과 대조해 여러분의 번역으로 바꾸고, 게임의 활성 언어를 번역된 것으로 강제해 화면과 UI 텍스트가 따라오게 합니다.
• tl/translated/translation.rpy — Ren’Py가 자체 메커니즘으로 안정적으로 해석하는 _() UI / 화면 문자열(버튼, 메뉴, 툴팁)만 담습니다.
• 대상 언어에 필요할 때 번들된 폰트와 zzz_runetranslate_font.rpy — 아래 비라틴 주석 참고.

게임의 .exe를 실행하면 원본 스크립트와 아카이브를 손대지 않은 채 대상 언어로 플레이됩니다. 되돌리려면 RuneTranslate가 추가한 파일 — rt_translations.json, zzz_runetranslate_language.rpy, 번들 폰트와 그 .rpy, tl/translated/ — 을 제거하세요.

비라틴 언어

대부분의 Ren’Py 게임은 라틴 전용 폰트를 배포하므로, 중국어, 한국어, 일본어, 태국어, 아랍어는 그렇지 않으면 빈 상자로 렌더링됩니다. 그중 하나를 대상으로 하면 RuneTranslate가 적합한 폰트(NanumGothic / Noto Sans)를 번들하고 게임이 쓰는 모든 폰트를 Ren’Py의 config.font_replacement_map으로 라우팅해, 게임 자체 에셋을 편집하지 않고도 번역된 텍스트가 올바르게 나옵니다.

알려진 한계

• 표준 RPA-2 / RPA-3 / RPA-3.2 / RPA-4.0과 흔한 벤더 난독화 아카이브는 자동으로 열립니다. 진짜 비표준 컨테이너나 외부에 보관된 키는 언팩되지 않을 수 있습니다.
• 이미지에 새겨진 텍스트(타이틀 로고, 손으로 그린 UI, CG 캡션)는 픽셀 작업이라 번역되지 않습니다 — 기계 번역 범위 밖입니다.
• 변수에서 런타임에 문자열을 조립하는 짙게 스크립트된 화면은 편집기에서 빠른 손 수정 패스가 필요할 수 있습니다.

왜 이것이 옛 방식보다 쉬운가

수동 경로는 .rpyc를 손으로 디컴파일하고, 아카이브에 rpatool을 돌린 뒤, 소스를 제자리에서 번역하거나(다음 게임 업데이트에 다시 깨짐) tl/ 블록을 한 줄씩 손으로 작성해야 했습니다 — 그리고 비라틴 언어에서는 여전히 빠진 폰트와 싸워야 했습니다. RuneTranslate는 디컴파일 + 언팩 + 추출 + 런타임 훅 사슬을 몇 번의 클릭으로 해내며, 편집기를 열어둬 여러분이 표현을 통제하게 합니다.

전체 기능 목록은 Ren’Py 엔진 페이지 보기, 다른 VN 엔진은 Kirikiri 비주얼 노벨 가이드를 읽거나, RuneTranslate 다운로드해 실제 게임에서 시험해 보세요.