Paradox Auto Translate(PAT)는 Paradox Interactive 게임(예: Crusader Kings III, Victoria 3, Stellaris)의 영어 현지화 파일을 한국어로 자동 번역하는 도구입니다. 이 문서는 비개발자 사용자를 위해, 번역 모드를 다운로드하고 사용하는 방법을 쉽게 안내합니다.

준비물#

• Node.js v18 이상: Node.js 공식 사이트에서 다운로드 및 설치
• pnpm 10.24.0 이상: pnpm 설치 안내
• Git 최신 버전: Git 공식 사이트에서 다운로드 및 설치
• Google Gemini API 키: Google AI Studio에서 회원가입 후 API 키 발급

설치 방법#

1. PAT 저장소 다운로드

   ⧉

   git clone https://github.com/dungsil/paradox-auto-translate.git
   cd paradox-auto-translate
   

   위 명령어를 실행하면 PAT 프로그램이 내 컴퓨터에 다운로드됩니다.

2. 필수 프로그램 설치

   ⧉

   pnpm install
   

   PAT가 동작하는 데 필요한 추가 프로그램(의존성)이 자동으로 설치됩니다.

3. API 키 등록

   ⧉

   cp .env.sample .env
   

   위 명령어로 환경설정 파일을 만듭니다.
   폴더 내 .env 파일을 메모장 등으로 열고, 아래와 같이 본인의 Google Gemini API 키를 입력합니다.

   ⧉

   GOOGLE_GENERATIVE_AI_API_KEY=여기에_본인_API_키_입력
   

번역 실행 방법#

PAT는 명령어를 통해 게임별 번역을 실행합니다. 아래 예시처럼 입력하면 번역이 시작됩니다.

# Crusader Kings III 전체 번역
pnpm ck3

# Victoria 3 전체 번역
pnpm vic3

# Stellaris 전체 번역
pnpm stellaris

번역이 완료되면, 각 게임의 모드 폴더 내 localization/korean/ 경로에 ___event_l_korean.yml과 같이 파일명이 ___로 시작하는 번역 파일이 생성됩니다. 이 파일들은 게임에서 자동으로 인식되어 한글 번역이 적용됩니다.

자주 묻는 질문 및 문제 해결#

설치 또는 실행 중 오류가 발생할 경우, 문제 해결 문서를 참고하세요. 대표적인 오류와 해결 방법이 정리되어 있습니다.

이 안내서는 비개발자 사용자가 Paradox Auto Translate를 쉽고 빠르게 설치하여 번역 기능을 사용할 수 있도록 작성되었습니다. 추가적인 기능이나 상세 명령어는 사용법 문서를 참고하세요.