TyranoBuilder / TyranoScript 게임을 영어로 번역하는 방법

TyranoBuilder와 그 바탕의 TyranoScript 엔진은 인디 일본 비주얼 노벨의 큰 카탈로그를 구동합니다 — Kirikiri와 Ren’Py의 웹 기술(HTML5 / JavaScript) 대안으로, 독립형 HTML5 폴더나 Electron으로 감싼 실행 파일로 배포됩니다. 그 시나리오는 Kirikiri와 같은 KAG 스타일 .ks 문법을 쓰므로, 텍스트가 어디 있는지 알면 닿기 쉽습니다. 이 가이드는 RuneTranslate로 TyranoBuilder 게임을 처음부터 끝까지 번역하는 과정을 안내하며, 대부분의 도구가 놓치는 부분을 포함합니다: 캐릭터 표시 이름.

필요한 것

• Windows용 RuneTranslate — 무료. 모든 엔진과 제공자가 열려 있습니다.
• TyranoBuilder 게임: 독립형 HTML5 폴더(낱개 data/와 tyrano/ 디렉터리)나 Electron 빌드(tyrano/tyrano.js와 data/scenario/*.ks를 담은 resources/app.asar). RuneTranslate가 둘 다 감지합니다.
• 대상 언어 — 영어, 스페인어, 프랑스어, 독일어, 중국어, 그 외 30개 이상.
• 제공자 하나. 비주얼 노벨은 대사가 많으니 LLM(OpenAI / Anthropic)이나 DeepL이 가장 잘 읽힙니다. 무료 Google Translate는 바로 작동합니다.

1단계: 게임 폴더 열기

RuneTranslate를 실행하고 새 프로젝트를 클릭한 뒤 게임 디렉터리(Electron 빌드의 경우 .exe가 있는 폴더)를 지정하세요. 감지가 TyranoBuilder를 그 tyrano/ 런타임과 data/scenario/ 스크립트로 인식하며, Electron 빌드에서는 app.asar를 직접 읽으므로 아무것도 언팩하지 않습니다. 원본 게임은 절대 수정되지 않습니다.

2단계: 문자열이 추출되는 방식

RuneTranslate는 TyranoBuilder가 저장하는 모든 곳에서 번역 가능한 텍스트를 끌어옵니다:

• 시나리오 스크립트 — 모든 data/scenario/**/*.ks 파일, _preview.ks와 암호화된 빌드가 의존하는 system/_*.ks 미러 포함.
• UI와 설정 — tyrano/lang.js와 data/system/Config.tjs.
• 캐릭터 표시 이름 — 대사 위에 표시되는 화자 라벨(다음 절).

KAG 인라인 태그 — [r] 줄바꿈, [p] 클릭 대기, [改ページ] 페이지 나누기, [font color=...], 그리고 JP 이름 태그 — 는 무언가가 제공자에 닿기 전에 숫자 [[U#]] 플레이스홀더 뒤에 가려졌다가 내보내기 시 복원되어 서식이 온전히 살아남습니다. 바이너리나 암호화된 .ks 파일은 UTF-8 스니핑으로 감지되어 절대 덮어쓰이지 않습니다.

3단계: 캐릭터 이름 — Tyrano 특유의 부분

시나리오는 흔히 화자를 [yuki] 같은 인라인 약칭 — 표시 텍스트가 아니라 캐릭터 ID — 으로 지칭합니다. RuneTranslate는 그 참조를 절대 다시 쓰지 않습니다(그러면 엔진의 캐릭터 조회가 깨져 장면이 충돌합니다). 대신 표시 이름을 번역하고 내보내기 시 data/system/chara_define.ks에 제대로 된 [chara_new name=... jname=...] 항목을 주입합니다. 화면에 표시되는 이름은 번역되고, 스크립트가 쓰는 ID는 손대지 않은 채 남습니다.

4단계: 번역하고 검토하기

제공자를 골라 실행하세요. LLM(OpenAI / Anthropic)이 캐릭터의 목소리에 가장 잘 읽히고, DeepL은 서술에 빠르고 깔끔하며, 무료 Google Translate는 메뉴를 커버합니다. 모든 루트에서 이름이 똑같이 렌더링되도록 등장인물과 반복 용어를 먼저 용어집에 넣으세요 — 용어집 101을 참고하세요. 모든 줄이 원본 옆의 편집기에 도착합니다. 인라인으로 편집하고(포커스 해제나 Ctrl+Enter에 저장), 찾기·바꾸기를 쓰거나, 선택적 AI 리파이너로 문맥 인식 2차 패스를 돌리세요. 무료 등급은 속도가 적당히 조절됩니다 — AI 제공자에서 유료 처리량의 대략 절반 — 출력 품질은 동일합니다.

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

내보내기를 클릭하세요. 독립형 HTML5 게임의 경우 RuneTranslate가 번역된 .ks 스크립트, lang.js, 설정, 주입된 chara_define.ks를 게임 복사본에 씁니다. Electron 빌드의 경우 수정된 app.asar를 다시 패킹합니다. 어느 쪽이든 여러분이 고른 위치에 완전하고 실행 가능한 복사본을 얻습니다 — 실행하면 대상 언어로 플레이됩니다.

알려진 한계

• 암호화된 .ks 파일(비UTF-8로 감지됨)은 손대지 않은 채 남으므로, 암호화된 빌드의 시나리오는 번역되지 않습니다.
• 이미지 텍스트(로고, 손으로 그린 UI, CG 캡션)는 기계 번역 범위 밖입니다.
• 런타임에 대사를 조립하는 커스텀 플러그인은 편집기에서 빠른 손 수정이 필요할 수 있습니다.

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

수동 경로는 app.asar를 언팩하고, 모든 .ks 파일(놓치기 쉬운 시스템 미러 포함)을 찾고, KAG 태그를 손으로 피해 번역하고, 캐릭터 이름 주입을 알아낸 뒤, asar를 손상시키지 않고 다시 패킹해야 했습니다. RuneTranslate는 전체 사슬을 몇 번의 클릭으로 접어 넣으며, 편집기를 열어둬 여러분이 표현을 통제하게 합니다.

전체 기능 목록은 TyranoBuilder 엔진 페이지 보기, 관련 KAG 엔진은 Kirikiri 가이드를 읽거나, RuneTranslate 다운로드해 실제 게임에서 시험해 보세요.