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.8,
  "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 컨트롤

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

GDScript

번역에 접근하려면 tr 함수를 사용하세요:

tr("WELCOME")

C#

번역에 접근하려면 Tr 함수를 사용하세요:

Tr("WELCOME")

6단계. 번역 테스트하기

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

알려진 제한사항

Godot가 지원하는 로케일 코드는 Lingo.dev가 지원하는 로케일 코드와 일치하지 않을 수 있습니다. 사용 가능한 로케일 코드에 대해 알아보려면 공식 문서를 참조하세요.

다음 단계

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