Godot - Lingo.dev CLI

Godot란 무엇인가요?

Godot는 2D 및 3D 게임을 제작하기 위한 오픈 소스 게임 엔진입니다. 게임 번역 관리를 위해 CSV 및 PO 파일 형식을 통한 국제화 지원이 내장되어 있습니다.

Lingo.dev CLI란 무엇인가요?

Lingo.dev는 AI 기반 번역 플랫폼입니다. Lingo.dev CLI는 소스 파일을 읽고, 번역 가능한 콘텐츠를 대규모 언어 모델에 전송한 후, 번역된 파일을 프로젝트에 다시 작성합니다.

이 가이드에 대하여

이 가이드는 Godot 게임 프로젝트에서 Lingo.dev CLI를 설정하는 방법을 설명합니다. 번역 파일 구성, 번역 파이프라인 설정, 게임에 번역 통합 방법을 배우게 됩니다.

1단계. 번역 파일 설정

게임의 번역 가능한 문자열을 위한 CSV 파일을 생성합니다(예: strings.csv):

keys,en
WELCOME,"Hello, world"

Godot는 이 CSV에서 .translation 파일을 자동으로 생성합니다(예: strings.en.translation, strings.es.translation).

참고: Godot에서는 키를 대문자로 작성하는 것이 관례이지만, 이것이 엄격하게 요구되는 것은 아닙니다.

2단계. CLI 구성

Godot 프로젝트의 루트에 i18n.json 파일을 생성합니다:

{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.10",
  "locale": {
    "source": "en",
    "targets": ["es"]
  },
  "buckets": {
    "csv": {
      "include": ["strings.csv"]
    }
  }
}

이 파일은 다음을 정의합니다:

Lingo.dev CLI가 번역해야 하는 CSV 파일
번역할 언어

이 경우, 구성은 CSV 파일을 영어에서 스페인어로 번역합니다.

3단계. 콘텐츠 번역

Lingo.dev 계정에 가입합니다.
CLI를 통해 Lingo.dev에 로그인합니다:
```
npx lingo.dev@latest login
```
번역 파이프라인을 실행합니다:
```
npx lingo.dev@latest run
```
CLI는 번역된 콘텐츠로 CSV 파일을 업데이트하고, 번역된 내용을 추적하기 위한 i18n.lock 파일을 생성합니다(불필요한 재번역 방지).

4단계. Godot에서 언어 설정

프로젝트 > 프로젝트 설정으로 이동합니다.
지역화 탭으로 전환합니다.
추가를 클릭합니다.
자동 생성된 .translation 파일을 선택합니다.
열기를 클릭합니다.

5단계. 번역 사용

UI 컨트롤

노드(예: Button 또는 Label)를 선택합니다.
노드의 인스펙터 창을 엽니다.
Text 속성을 번역 파일의 키로 설정합니다(예: "WELCOME").
자동 번역 옵션이 활성화되어 있는지 확인합니다. (기본적으로 활성화되어 있습니다.)

GDScript

번역에 액세스하려면 tr 함수를 사용합니다:

tr("WELCOME")

C#

번역에 액세스하려면 Tr 함수를 사용합니다:

Tr("WELCOME")

6단계. 번역 테스트

프로젝트 > 프로젝트 설정으로 이동합니다.
고급 설정을 활성화합니다.
국제화 > 로케일로 이동합니다.
테스트 필드에 로케일을 입력합니다(예: "es").
게임을 실행합니다.

알려진 제한 사항

Godot가 지원하는 로케일 코드가 Lingo.dev가 지원하는 로케일 코드와 일치한다고 보장할 수 없습니다. 사용 가능한 로케일 코드를 확인하려면 공식 문서를 참조하세요.

다음 단계

Godot의 번역 시스템에 대해 자세히 알아보려면 다음을 참조하세요: