Localization Checker

Unity 에디터에서 현지화 품질 검사

플레이어보다 먼저
현지화 문제를 찾으세요.

언어마다 테스트 플레이 한 판.

Localization Checker는 Unity 다국어 UI를 검사하는 도구입니다. 텍스트 넘침과 겹침, 폰트에 없는 글자, 플레이스홀더와 리치 텍스트 오류, 미번역 텍스트를 찾아냅니다. 선택한 언어와 해상도를 한 번의 스캔으로 검사하고, 게임 실행 중 생성되거나 갱신되는 화면은 플레이 모드에서 확인할 수 있습니다.

기존 번역을 검사하는 도구이며, 자동 번역이나 문장 재작성 기능은 제공하지 않습니다.

Unity Asset Store · 출시 예정Tuanjie Store(중국) · 출시 예정itch.io · 출시 예정 문서 보기(영어, 중국어 간체)

Unity 2022.3 LTS 이상(Unity 6 포함)과 Tuanjie Engine 2022.3을 지원합니다. TextMeshPro와 레거시 UI Text의 텍스트를 검사합니다. UI Toolkit 텍스트 검사는 Unity 6에서만 지원합니다.

한 번 스캔하면, 모든 언어가 보입니다.

  1. 플러그인 창 상단: 번역 파일, 범위는 열린 씬, 검사할 언어, 텍스트 언어는 en, 해상도는 1920x1080.

    번역을 연결하고 언어와 해상도를 고르기

  2. 모든 언어 × 모든 해상도 × 5가지 검사

    스캔은 한 번

  3. 스캔 후의 개요 표: 행은 de, ja, (언어 없음), Sources, 열은 넘침, 없는 글리프, 플레이스홀더, 리치 텍스트 태그, 번역. 독일어 넘침 2건과 일본어의 없는 글리프 15건이 빨간 칸입니다.

    어떤 언어에 어떤 문제가 있는지 표 하나로

  4. 씬 뷰의 히트맵: Demo 메인 메뉴의 제목과 버튼에 번호가 붙은 색상 테두리가 있고, 범례는 1(넘침)부터 5(넘침 직전)까지입니다.

    내 UI 위에 문제 종류별 번호로 표시

이렇게 찾아냅니다

Unity 씬 뷰에서 독일어 종료 버튼 레이블 “Spiel beenden”이 버튼 밖으로 넘쳐 있으며, 텍스트 전체를 둘러싼 빨간 테두리가 표시되어 있다. “de · Text overflows · 1920x1080” 레이블이 함께 보인다.
독일어 종료 버튼의 글자가 주어진 공간에 들어가지 않습니다. 플러그인이 Unity에서 실측한 넘침 문제를 표시합니다.
스캔 후의 문제 목록. “星明かりの物語”, “スタート” 같은 일본어 텍스트가 Critical “Missing glyphs”로 한 줄씩 나열되고, 각 행에 Engine Metadata와 ja가 표시됩니다.
Demo 폰트로는 표시할 수 없는 일본어 텍스트. 한 번만 스캔하면 텍스트마다 한 줄씩 모두 나열됩니다.

버튼 하나, 아홉 가지 언어

Unity 씬 뷰에서 독일어 종료 버튼 레이블 “Spiel beenden”이 버튼 밖으로 넘쳐 있으며, 텍스트 전체를 둘러싼 빨간 테두리가 표시되어 있다. “de · Text overflows · 1920x1080” 레이블이 함께 보인다.

영어를 포함한 아홉 가지 언어 버전을 보여 주는 브라우저 애니메이션입니다. 독일어 텍스트는 영역을 벗어나고, 예시 폰트에는 중국어·일본어·한국어 글리프가 누락되어 있습니다. 진단 테두리와 태그가 두 가지 문제를 모두 표시합니다.

없는 글자를 폰트별로 정리

스캔 후의 개요. 언어 × 검사 항목 표에는 일본어의 Missing glyphs가 15건, Language coverage에는 Lato SDF에 일본어 글자가 없다고 표시되며, “The scan’s missing characters by font”에는 Lato SDF.asset에 없는 글자 56개와 “Copy for Font Asset Creator” 버튼이 있습니다.
개요에서는 없는 글리프를 언어별로 집계하고, 어떤 폰트 에셋이 어떤 언어를 지원하는지 보여 주며, 없는 글자를 폰트별로 정리합니다. 클릭 한 번이면 Unity의 Font Asset Creator에 붙여 넣을 수 있는 형태로 복사됩니다.

검사 항목

  • 텍스트 넘침과 레이아웃

    선택한 각 언어와 해상도에서 Unity의 텍스트 엔진으로 UI 복사본을 측정합니다. 텍스트 넘침과 잘림, Auto Size로 글자가 지나치게 작아지는 문제를 찾아냅니다. 지원되는 텍스트 컴포넌트에서는 텍스트가 영역에 들어가는 최대 폰트 크기, Auto Size, 줄 바꿈 같은 수정안도 엔진으로 시험한 후 제안합니다.

  • 폰트에 없는 글자와 커버리지

    지정된 폰트와 폴백 폰트가 텍스트를 표시할 수 있는지 검사합니다. 내장된 언어별 문자 집합을 기준으로 폰트 커버리지를 확인하고, 누락된 문자를 복사해 Font Asset Creator에서 사용할 수 있습니다. 커버리지 프리셋에는 Steam이 완전히 지원하는 언어가 포함됩니다.

  • 플레이스홀더, 태그, 번역

    플레이스홀더의 누락이나 변경, 닫히지 않았거나 잘못 중첩된 리치 텍스트 태그, 누락되거나 비어 있는 번역, TODO 표시를 찾아냅니다. 인코딩 오류가 의심되는 텍스트와 원문과 동일한 번역은 검토가 필요한 항목으로 표시합니다. 현지화 시스템에 연결되지 않은 하드코딩된 UI 텍스트도 찾아냅니다.

  • 플레이 모드에서 화면 검사

    실행 중인 게임에서 검사할 화면을 연 다음, Localization Checker 창을 클릭해 포커스를 옮기고 F8을 누르세요. 순찰 기능은 프로젝트의 현지화 시스템으로 선택한 언어를 차례로 전환하면서 표시 중인 UI를 검사하고, 언어별로 스크린샷을 저장합니다. 런타임에 생성된 UI도 검사할 수 있습니다.

개요부터 개별 문제까지

언어별·검사 항목별 표, Canvas별 문제 집중 영역, 언어별 폰트 커버리지, 폰트별 누락 문자를 보여 주는 Localization Checker 개요 화면.
언어와 문제 유형을 비교하고, 문제가 있는 화면과 폰트 커버리지를 확인합니다.
심각도순으로 정렬된 문제 목록에서 독일어 종료 버튼이 선택되어 있고, 씬 뷰에는 “Spiel beenden”의 텍스트 경계가 테두리로 표시되어 있다.
문제를 선택해 해당 오브젝트를 찾습니다. 미리 보기를 지원하는 스캔 결과에서는 번역이 표시되는 모습도 확인할 수 있습니다.
문제가 있는 텍스트 컴포넌트를 번호가 붙은 테두리로 표시한 씬 뷰 히트맵. 테두리는 문제 유형별로 색이 다르다.
히트맵으로 UI의 어느 위치에 문제가 있는지 확인합니다.

프로젝트에서의 작동 방식

  • 스캔은 숨겨진 미리 보기 씬에서 UI 복사본을 측정하며, 원본 씬·프리팹·에셋을 수정하거나 저장하지 않습니다. 씬 미리 보기에서는 표시 텍스트를 임시로 바꾸었다가 복원합니다. 미리 보기와 플레이 모드 순찰이 미치는 영향은 매뉴얼을 확인해 주세요.
  • 에디터 전용으로, 빌드에는 아무것도 포함되지 않습니다. 서드파티 DLL을 사용하지 않고 네트워크에도 연결하지 않습니다. C# 소스 코드 전체가 포함되어 있습니다.
  • Unity Localization과 I2 Localization 또는 직접 만든 CSV, Excel, JSON, XLIFF, gettext PO 파일을 지원합니다. 인터페이스와 문서는 영어와 중국어 간체로 제공됩니다.
  • 문제 목록을 CSV 또는 오프라인 HTML 보고서로 내보낼 수 있습니다. CI(지속적 통합)용 명령줄도 제공합니다.