XUnity.AutoTranslator는 Unity 기반 게임에서 텍스트를 실시간으로 번역하여 언어 장벽 없이 게임을 즐길 수 있도록 돕는 강력한 도구입니다. 다양한 플러그인 프레임워크와 번역 서비스를 지원하며, 전 세계 게이머들에게 완벽한 다국어 지원을 제공합니다.
XUnity.AutoTranslator 사용 이유
- 다양한 프레임워크 호환성: BepInEx, MelonLoader, IPA, UnityInjector 등 주요 플러그인 프레임워크와 호환됩니다.
- 풍부한 번역 서비스 지원: Google, Bing, DeepL 등 다양한 번역 엔진을 내장하고 있으며, 사용자 정의 번역 인터페이스도 지원합니다.
- 지능적인 텍스트 처리: UGUI, NGUI, TextMeshPro 등 다양한 텍스트 컴포넌트를 자동으로 인식하고 번역합니다.
- 유연한 설정 옵션: 번역 언어, 텍스트 처리 규칙, UI 조정 전략 등을 사용자가 직접 설정할 수 있습니다.
- 성능 최적화: 캐싱 메커니즘과 요청 제한 정책을 통해 게임 성능 저하를 최소화합니다.
설치 절차
1. 설치 파일 다운로드
프로젝트 저장소에서 코드를 복제하거나 릴리스 페이지에서 최신 버전을 다운로드합니다.
git clone https://gitcode.com/gh_mirrors/xu/XUnity.AutoTranslator
2. 플러그인 프레임워크에 맞는 설치
BepInEx 설치 (권장)
XUnity.AutoTranslator-BepInEx-{버전}.zip파일을 다운로드합니다.- 압축을 해제하고 DLL 파일을
{게임 설치 폴더}/BepInEx/plugins/XUnity.AutoTranslator/경로에 복사합니다. - 게임을 실행하면 설정 파일이 자동으로 생성됩니다.
파일 구조 예시:
{게임 설치 폴더}/BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.Plugin.Core.dll
{게임 설치 폴더}/BepInEx/plugins/XUnity.AutoTranslator/XUnity.AutoTranslator.Plugin.BepInEx.dll
{게임 설치 폴더}/BepInEx/plugins/XUnity.AutoTranslator/Translators/{번역기_DLL}.dll
MelonLoader 설치
XUnity.AutoTranslator-MelonMod-{버전}.zip파일을 다운로드합니다.- 압축을 해제하고 DLL 파일을
{게임 설치 폴더}/Mods/및{게임 설치 폴더}/UserLibs/경로에 복사합니다. - 게임을 실행하여 설치를 완료합니다.
주요 설정 가이드
설정 파일은 게임 설치 폴더 내의 해당 플러그인 폴더에 위치합니다. 주요 설정 항목은 다음과 같습니다.
기본 설정
[Service]
Endpoint=GoogleTranslate ; 사용할 번역 서비스 (예: GoogleTranslate, DeepL, BaiduTranslate)
FallbackEndpoint= ; 번역 서비스 오류 시 사용할 대체 서비스
[General]
Language=ko ; 번역 대상 언어 (예: ko, en, ja)
FromLanguage=en ; 원본 언어 ("auto"로 설정 시 자동 감지)
텍스트 프레임워크 설정
게임 내에서 사용되는 UI 텍스트 시스템을 활성화합니다.
[TextFrameworks]
EnableUGUI=True ; UGUI 텍스트 번역 활성화
EnableNGUI=True ; NGUI 텍스트 번역 활성화
EnableTextMeshPro=True ; TextMeshPro 텍스트 번역 활성화
EnableTextMesh=False ; TextMesh 텍스트 번역 비활성화 (기본값)
EnableIMGUI=False ; IMGUI 텍스트 번역 비활성화 (기본값)
동작 설정
번역 동작과 관련된 고급 설정을 구성합니다.
[Behaviour]
MaxCharactersPerTranslation=150 ; 한 번에 번역할 최대 문자 수
EnableUIResizing=True ; 번역 후 UI 크기 자동 조정 활성화
OverrideFont= ; UI 텍스트에 적용할 사용자 정의 폰트 경로 (UGUI 전용)
FallbackFontTextMeshPro= ; TextMeshPro의 대체 폰트 경로
번역 서비스별 설정
각 번역 서비스에 필요한 API 키 또는 설정을 구성합니다.
Google 번역
[Google]
ServiceUrl= ; 사용자 정의 Google 번역 API 주소 (필요시)
DeepL 번역 (API 키 필요)
[DeepLLegitimate]
ApiKey=your_deepl_api_key ; 발급받은 DeepL API 키
Free=False ; 무료 API 사용 여부
Baidu 번역 (App ID 및 Secret 필요)
[Baidu]
BaiduAppId=your_baidu_app_id ; Baidu App ID
BaiduAppSecret=your_baidu_secret ; Baidu Secret Key
유용한 단축키
플러그인 사용 편의성을 높이는 단축키입니다.
ALT + 0: XUnity AutoTranslator UI 토글 (숫자 0)ALT + T: 원본 텍스트와 번역 텍스트 간 전환ALT + R: 번역 파일 새로고침ALT + U: 수동으로 텍스트 스캔 및 번역 시도ALT + F: 사용자 정의 폰트 적용 토글
수동 번역 및 파일 관리
번역 파일 구조
자동으로 생성되거나 사용자가 편집할 수 있는 번역 파일의 위치는 다음과 같습니다.
- BepInEx:
{게임 설치 폴더}/BepInEx/Translation/{언어코드}/Text/_AutoGeneratedTranslations.txt - ReiPatcher:
{게임 설치 폴더}/AutoTranslator/Translation/{언어코드}/Text/_AutoGeneratedTranslations.txt
파일 형식은 간단합니다:
원본 텍스트=번역된 텍스트
정규 표현식을 이용한 번역 규칙
특정 패턴을 가진 텍스트에 대해 일괄 번역 규칙을 적용할 수 있습니다.
r:"^Simple Ring ([0-9]+)$"=심플 링 $1
조합 텍스트 분리 규칙
여러 텍스트가 조합된 경우, 이를 분리하여 번역 규칙을 적용할 때 사용합니다.
sr:"^([0-9]{2}) ([\S\s]+)$"=$1 $2
문제 해결
Q: 번역 후 UI 레이아웃이 깨집니다.
UI 조정 설정을 변경해 보세요.
[Behaviour]
EnableUIResizing=True
ResizeUILineSpacingScale=0.7 ; 줄 간격 조정 비율 (값 조정 필요)
Q: 자동 번역을 비활성화하고 싶습니다.
설정 파일에서 번역 서비스 설정을 비워두세요.
[Service]
Endpoint=
Q: 번역 요청 제한에 걸립니다.
번역 요청 간격을 늘리세요.
[Google]
MinDelay=3
MaxDelay=10
고급 활용 팁
플러그인별 번역 파일 관리
각 플러그인에 대한 번역 파일을 별도로 관리할 수 있습니다.
Translation/{언어코드}/Text/Plugins/{플러그인_이름}.txt
번역 범위 제한
게임 내 특정 상황이나 장면에 대해서만 번역을 적용하도록 설정할 수 있습니다.
#set level 1,2,3
특정 장면에 나올 텍스트=Translated text for specific scenes
텍스트 전처리
번역 요청 전에 텍스트를 수정하는 규칙을 적용할 수 있습니다.
[Files]
PreprocessorsFile=Translation\{언어코드}\Text\_Preprocessors.txt
권장 사용법
- 수동 번역 우선: 중요한 텍스트는 직접 번역 파일을 편집하여 품질을 높이는 것이 좋습니다.
- 번역 파일 백업: 게임이나 플러그인 업데이트 시 사용자 정의 번역이 유실되지 않도록 주기적으로 백업하세요.
- 다양한 번역 서비스 테스트: 특정 언어 쌍에 대해 번역 서비스마다 품질 차이가 있을 수 있습니다.
- 번역 요청 모니터링: 로그를 통해 번역 요청 현황을 파악하고 서비스 제한을 피하세요.
- UI 최적화: 게임 특성에 맞게 폰트 및 UI 크기 설정을 조정하여 가독성을 높이세요.
XUnity.AutoTranslator를 통해 Unity 게임의 한글화를 손쉽게 진행하고, 언어의 제약 없이 다양한 게임을 즐기시기 바랍니다.