지원 엔진 · Unity
Unity 게임 번역기 — 일본어 등 모든 언어의 Unity 게임을 처음부터 끝까지 번역
현대 인디 게임의 큰 몫 — RPG, 비주얼 노벨, 시뮬레이션 타이틀 — 이 Unity로 배포됩니다. RuneTranslate는 그 게임들이 외부화하는 텍스트를 번역합니다: TextAsset 페이로드(JSON / CSV / TSV / 일반 텍스트 시나리오 블롭)와 .assets, 레벨 파일, AssetBundle(단일 번들 data.unity3d 게임 포함) 안에 패킹된 MonoBehaviour 문자열 필드, 그리고 StreamingAssets 아래 낱개 스크립트 파일. RuneTranslate가 바이너리 에셋을 직접 읽고 쓰며, 모두 프로젝트별 작업 공간에서 이루어져 원본 게임이 손대지 않은 채 유지됩니다. MonoBehaviour 텍스트는 Mono와 IL2CPP 빌드 양쪽에서 처리됩니다 — Mono에서는 타입 트리가 게임의 Managed/*.dll에서 나오고, IL2CPP에서는 RuneTranslate가 GameAssembly.dll + global-metadata.dat에서 재구성합니다(파싱 가능한 메타데이터 필요). 또한 패킹된 Addressable 번들을 읽고 CJK 및 기타 스크립트를 위한 비라틴 폴백 폰트를 주입합니다. Mono 빌드에서는 Assembly-CSharp.dll에 컴파일된 문자열 리터럴도 읽고, 코드가 이름이나 키로 쓰는 것은 제외합니다. IL2CPP 빌드의 네이티브 코드에 컴파일된 텍스트는 범위 밖입니다. 공유하기 전에 내보낸 게임의 화면 몇 개를 확인하세요.
Unity VN/RPG 스크립트는 보통 JSON이나 CSV 테이블로 외부화되어, 캐릭터 이름과 반복 용어가 여러 TextAsset에 걸쳐 수백 번 나타납니다. 제공자는 배치마다 그것들을 일관성 없이 다시 표현합니다. 주인공, 파티, 반복 NPC, 지명, 대표 스킬이나 시스템 용어를 미리 용어집에 넣어, 모든 TextAsset과 StreamingAssets 파일이 그것들을 똑같이 렌더링하게 하세요.
Unity 번역하는 방법
- 단계 1
Unity 게임 폴더 열기
RuneTranslate를 게임 디렉터리(<Name>_Data 폴더가 있는 곳)로 지정하세요. 엔진 감지가 globalgamemanagers / data.unity3d / resources.assets를 찾습니다. 에셋 리더가 RuneTranslate에 내장되어 있어 따로 설치할 것이 없습니다.
- 단계 2
외부화된 텍스트 추출
RuneTranslate는 직렬화된 파일에서 원본 언어의 TextAsset과 MonoBehaviour 문자열(기본은 일본어. 프로젝트마다 지원되는 아무 원본 언어 설정 가능)과 StreamingAssets 아래 낱개 스크립트 파일을 훑습니다. 구조화된 페이로드(JSON / KAG / HTML)는 개별 번역 가능한 줄로 잘려, 파일 구조가 온전히 왕복됩니다.
- 단계 3
선호하는 제공자로 번역
DeepL은 서사 대사에 강력한 기본값이고, OpenAI GPT-4o나 Anthropic Claude는 개성 있는 말투와 의성어를 더 잘 처리합니다. 무료 Google Translate나 로컬 모델(Ollama / LM Studio)은 메뉴 문자열과 아이템 이름을 커버합니다. 제공자 라우팅이 짧은 문자열을 저렴한 차선으로 나눌 수 있습니다.
- 단계 4
번역된 빌드 내보내기
내보내기 시 RuneTranslate가 게임을 복사하고 번역된 문자열을 에셋 파일과 StreamingAssets 스크립트에 제자리로 다시 씁니다. 번역된 빌드는 원본처럼 실행됩니다 — 수동 에셋 저글링 없음.
지원 항목
- TextAsset 페이로드(JSON / CSV / TSV / .txt / .ks 시나리오 블롭)
- Mono와 IL2CPP 빌드 양쪽의 MonoBehaviour 문자열 필드 — 타입 트리가 Managed/*.dll(Mono)에서 나오거나 GameAssembly.dll + global-metadata.dat(IL2CPP)에서 재구성됨
- 낱개 StreamingAssets 스크립트 파일(.json / .txt / .csv / .ks / .js / .html / …)
- .assets, 레벨 파일, AssetBundle(단일 번들 data.unity3d + 패킹된 Addressable 번들 포함)
- 앱의 게임 캐시 안 프로젝트별 작업 공간(기본값은 userData/unity-workspace/<projectId>/, 설정 > 앱 > 게임 캐시에서 이동 가능)
제한 사항
- IL2CPP 빌드의 네이티브 코드(GameAssembly.dll)에 컴파일된 문자열 리터럴은 번역되지 않습니다. Mono 빌드에서는 Assembly-CSharp.dll의 리터럴이 번역되며, 코드가 이름이나 키로 쓰는 것은 제외됩니다
- IL2CPP MonoBehaviour 지원에는 파싱 가능한 global-metadata.dat가 필요합니다. 짙게 난독화된 메타데이터는 재구성되지 않을 수 있습니다
- RuneTranslate가 인식하지 못하는 패킹 형식의 AssetBundle은 건너뜁니다

