unity · tutorial · engine
Unity 게임을 한국어로 번역하는 방법
RuneTranslate로 Unity 게임을 번역하세요 — TextAsset, MonoBehaviour 필드(Mono와 IL2CPP), StreamingAssets를 읽는 것, 닿을 수 있는 텍스트의 범위(Mono의 컴파일된 C# 텍스트 포함), 그리고 식별자 가드가 어떻게 게임을 깨뜨리지 않게 막는지.
Unity는 점점 더 많은 일본 인디 게임과 비주얼 노벨 뒤에 있는 엔진이며 — 흔한 엔진 중 번역하기 가장 까다롭습니다. Unity에는 단일한 텍스트 형식이 없기 때문입니다. 대사는 TextAsset 블롭에, MonoBehaviour 문자열 필드에, 낱개 StreamingAssets 스크립트에, 또는 C# DLL에 곧바로 컴파일되어 있을 수 있습니다. 이 가이드는 RuneTranslate로 Unity 게임을 번역하는 과정을 안내하며, 그만큼 중요하게, Unity를 다르게 만드는 한 가지 규칙을 설명합니다: 텍스트가 어디에 있느냐가 닿을 수 있는 범위를 정한다.
먼저 큰 주의사항: 텍스트가 어디에 있는가
RuneTranslate는 데이터에 있는 Unity 텍스트를 번역합니다 — 엔진이 런타임에 불러오는 에셋 파일, MonoBehaviour 컴포넌트의 문자열 필드(대사, 이름, 라벨) 포함. 그 필드를 Mono와 IL2CPP 빌드 양쪽에서 읽습니다. Mono에서는 타입 배치가 게임 자체 DLL에서 나오고, IL2CPP에서는 Managed/ 폴더가 없을 때 IL2CPP 메타데이터로부터 재구성됩니다. Mono 빌드에서는 게임의 C# 코드(Assembly-CSharp.dll)에 컴파일된 문자열 리터럴도 읽으며, 코드가 이름이나 키로 쓰는 것은 제외합니다. 닿을 수 없는 것은 IL2CPP 빌드의 네이티브 코드(GameAssembly.dll)에 컴파일된 텍스트입니다. 실제로 스크립트를 에셋과 컴포넌트에 두는 게임은 잘 번역되며 — 첫 단계인 프로젝트 열기가 여러분이 무엇을 가졌는지 알려줍니다.
필요한 것
- Windows 및 Linux용 RuneTranslate — 무료. 모든 엔진과 RuneLingua를 제외한 모든 제공자가 열려 있습니다.
- Unity 게임 폴더 — 게임
.exe와<GameName>_Data/폴더(globalgamemanagers,resources.assets,data.unity3d,level*파일을 담음)가 있는 디렉터리. - 대상 언어 — 영어, 스페인어, 프랑스어, 독일어, 포르투갈어, 러시아어, 중국어, 이탈리아어, 터키어, 베트남어, 그 외 20개 이상.
- 번역 제공자 하나. 무료 Google Translate는 바로 작동하고, DeepL은 무료 등급이 있으며, OpenAI, Anthropic, 로컬 모델, 모든 OpenAI 호환 API는 직접 키를 준비해야 합니다.
1단계: 게임 폴더 열기
RuneTranslate를 실행하고 새 프로젝트를 클릭한 뒤 Unity 게임 디렉터리를 지정하세요. 엔진 감지가 _Data/ 폴더를 찾아 프로젝트를 Unity로 식별합니다. RuneTranslate에 내장된 Unity 리더(앱 자체의 일부라 따로 설치할 것이 없습니다)가 에셋 파일을 열어 읽을 수 있는 문자열을 앱의 게임 캐시 안 프로젝트별 작업 공간으로 나열합니다(Windows 기본값은 %APPDATA%/RuneTranslate/unity-workspace/<projectId>/이며, 설정 > 앱 > 게임 캐시에서 옮길 수 있습니다). 원본 게임 폴더는 절대 수정되지 않습니다. 공유하기 전에 내보낸 빌드가 실행되는지 확인하세요.
2단계: 문자열이 추출되는 방식
RuneTranslate는 Unity가 텍스트를 외부화하는 모든 곳에서 그것을 읽습니다:
- TextAsset —
.assets와 AssetBundle에 내장된 JSON / CSV / 스크립트 블롭. 형식 인식 추출기로 잘라냅니다. - MonoBehaviour 문자열 필드 — 컴포넌트의 표시 텍스트(대사, 이름, 라벨), Mono와 IL2CPP 빌드 양쪽에서(타입 정보는 게임 자체 DLL에서 나오거나 IL2CPP 메타데이터로부터 재구성됨).
- StreamingAssets — 디스크에서 직접 훑는 낱개 스크립트 파일(
.json,.txt,.csv,.tsv,.xml,.yaml,.ks등). - 패킹된 Addressable 번들 — Addressable 에셋 번들을 패킹된 변형으로 배포하는 게임은 자동으로 읽히므로, 다른 번들처럼 텍스트가 추출됩니다.
Unity는 또한 과도 번역이 가장 큰 피해를 주는 곳이라, RuneTranslate가 그것을 위한 가드를 탑재합니다. 많은 MonoBehaviour 문자열은 표시 텍스트가 전혀 아닙니다 — 제어 식별자이자 흐름 피연산자입니다: LoadScene 호출이 문자열로 해석하는 씬 이름, 메시지 라우팅 키, 애니메이터 / 사운드 클립 이름, Live2D 파트 이름, Fungus If / SetVariable 로직 안의 비교 값(예: 村落出口 같은 플래그). 그것들을 번역하면 게임이 조용히 깨집니다 — 전형적인 증상은 오류 없는 무한 "로딩" 화면입니다. RuneTranslate는 이것들을 제외(빨간색으로 표시, 선택 시에만)로 자동 분류해, 편집기가 진짜 대사와 라벨을 드러내고 기계장치는 내버려 둡니다. Fungus {$var} 치환과 {color=...} / TMP <...> 마크업은 플레이스홀더 뒤에 가려져 번역을 온전히 살아남습니다.
3단계: 번역하고 검토하기
제공자를 골라 실행하세요. DeepL이나 LLM이 대사에 가장 잘 읽히고, 무료 Google Translate는 메뉴와 아이템 이름을 커버합니다. 등장인물과 반복 용어를 먼저 용어집에 넣으세요 — 용어집 101을 참고하세요. 모든 줄이 원본 옆의 편집기에 도착합니다. 인라인으로 편집하고(포커스 해제나 Ctrl+Enter에 저장), 선택적 AI 리파이너로 2차 교정을 돌리세요. 무료 등급은 적당한 조절로 실행됩니다(AI 제공자에서 대략 2배 느리고 무료 제공자에서는 그보다 덜) — 같은 엔진, 같은 출력 품질이며 유료는 그저 전속력으로 실행됩니다.
4단계: 실행 가능한 빌드 내보내기
내보내기를 클릭하세요. RuneTranslate는 게임을 복사한 뒤 번역된 문자열을 에셋 파일에 제자리로 다시 패치합니다. 같은 제외 가드가 되쓰기에서도 실행되어, 오래된 프로젝트가 다시 내보낼 때 번역된 씬 이름이나 흐름 피연산자를 실수로 밀어넣을 수 없습니다. 출력은 여러분이 고른 위치의 완전하고 실행 가능한 게임 복사본입니다 — .exe를 실행하면 대상 언어로 플레이됩니다.
게임 내장 폰트가 렌더링할 수 없는 글자를 가진 비라틴 언어(중국어, 일본어, 한국어, 태국어, 아랍어)로 번역하시나요? RuneTranslate가 내보내기 시 TextMeshPro 폰트 스택에 폴백 폰트를 주입하므로, 빠진 글자 상자 대신 번역된 텍스트가 나옵니다.
알려진 한계
- IL2CPP 빌드의 네이티브 코드(
GameAssembly.dll)에 컴파일된 텍스트는 번역되지 않습니다. Mono 빌드에서는Assembly-CSharp.dll의 문자열 리터럴이 번역되며(코드가 이름이나 키로 쓰는 것은 제외), MonoBehaviour 데이터 필드는 Mono와 IL2CPP 빌드 양쪽에서 읽힙니다. - IL2CPP MonoBehaviour 읽기에는 파싱 가능한
global-metadata.dat가 필요합니다. 짙게 난독화된 메타데이터는 재구성되지 않을 수 있습니다(최선의 노력). - 공유하기 전에 내보낸 게임이 실행되고 올바르게 읽히는지 확인하세요.
- 이미지 텍스트(로고, 손으로 그린 UI, CG 캡션)는 번역되지 않습니다. 이미지 스튜디오가 Unity 텍스처를 열지 않습니다.
왜 이것이 옛 방식보다 쉬운가
수동 Unity 번역은 UABE나 AssetStudio로 에셋을 언팩하고, 어느 TextAsset과 MonoBehaviour 필드가 진짜 텍스트를 담았는지 뒤지고, 게임을 충돌시키는 식별자 문자열을 손으로 피한 뒤, 에셋 테이블을 손상시키지 않고 다시 가져와야 했습니다. RuneTranslate는 추출, 분류(기계장치를 번역하지 않도록), 번역, 제자리 패치를 몇 번의 클릭으로 접어 넣으며 — 편집기를 열어둬 여러분이 표현을 통제하게 합니다.
전체 기능 목록은 Unity 엔진 페이지 보기, HTML 기반 엔진은 TyranoBuilder 가이드를 읽거나, RuneTranslate 다운로드해 실제 게임에서 시험해 보세요.
관련 읽을거리
RuneTranslate를 써볼 준비가 되셨나요?
무료 등급에서 모든 엔진과 RuneLingua를 제외한 모든 번역 제공자가 열립니다. Supporter($3.99/mo)로 최고 속도가 열립니다.
Windows, Mac 및 Linux용 다운로드
