홈 › 제이월드 블로그

작은 게임을 12개 언어로: 번역하는 것, 그리고 대신 그리는 것

제이월드 팀 ·

제이월드 팀이 게임 하나를 12개 언어로 내놓을 때 거치는 순서를 정리했어요. 언어 고르기, 폰트, 글자 넘침 검사, 번역 규칙까지 실제 기준 그대로 담았어요.

번역은 "문장을 바꾸는 일"처럼 보여요. 그런데 작은 게임에서는 문장보다 화면이 먼저 깨져요. 독일어 버튼은 한국어보다 길고, 태국어는 글자 위아래에 부호가 쌓이고, 베트남어는 악센트가 많아서 폰트가 없으면 글자가 깨져요.

제이월드 팀은 2026년 10월 22일부터 모든 게임을 12개 언어로 내는 걸 기본으로 삼았어요. 이 글은 그 기준(내부 문서 I18N.md)을 풀어 쓴 개발 노트예요. 어떤 언어를 넣는지, 무엇을 번역하고 무엇을 코드로 처리하는지, 출시 전에 무엇을 검사하는지 순서대로 볼게요.

12개 언어는 이렇게 골랐어요

기본 언어는 한국어예요. 한국어가 원문이고, 영어가 대체(fallback) 언어예요. 나머지 열 개는 아래와 같아요.

코드언어언어 메뉴에 보이는 이름문자
ko한국어한국어한글
en영어English라틴
ja일본어日本語가나 + 한자
zh-Hans중국어 간체简体中文한자(간체)
zh-Hant중국어 번체繁體中文한자(번체)
es스페인어Español라틴
pt-BR포르투갈어(브라질)Português (Brasil)라틴
de독일어Deutsch라틴
fr프랑스어Français라틴
id인도네시아어Bahasa Indonesia라틴
th태국어ไทย태국 문자
vi베트남어Tiếng Việt라틴 + 성조 부호

아직 넣지 않은 언어도 있어요. 아랍어와 히브리어는 글이 오른쪽에서 왼쪽으로 흐르기 때문에 화면 배치부터 새로 짜야 해서 뒤로 미뤘어요. 힌디어와 러시아어도 지금은 목록에 없어요.

언어 메뉴는 각 언어를 자기 문자로 보여 줘요. 그래서 메뉴만큼은 특별한 폰트 없이 기기 기본 글꼴로 그려요. 일본어를 모르는 사람도 "日本語"라는 모양만 보고 찾을 수 있게요.

어떤 언어로 시작할지 정하는 순서

게임을 열면 언어를 고르라고 묻지 않아요. 아래 순서로 알아서 정해요.

  1. 플레이어가 설정에서 직접 고른 언어
  2. 플랫폼이 알려 주는 언어(포털이나 앱 환경)
  3. 브라우저의 언어 목록(navigator.languages) 중 먼저 맞는 것
  4. 아무것도 맞지 않으면 영어

여기서 작은 규칙 하나가 중요해요. 목록에 12개 밖의 언어 태그가 먼저 나오면 영어로 바꾸지 않고 건너뛰어요. 브라우저 언어가 "러시아어, 일본어" 순이면 러시아어는 건너뛰고 일본어를 골라요. 러시아어를 영어로 바꿔 버리면 두 번째 후보인 일본어가 있어도 영어가 나오니까요.

태그를 12개로 묶는 규칙도 정해 뒀어요.

들어온 태그고르는 언어
zh-TW, zh-HK, zh-MO, zh-Hant중국어 번체
그 밖의 zh중국어 간체
pt로 시작하는 모든 것브라질 포르투갈어
id, in인도네시아어 (안드로이드는 옛 코드 in을 써요)
12개에 없는 언어영어

한 가지 함정도 있었어요. 예전에 한국어/영어 두 칸짜리 언어 칩이 있던 게임은, 저장 파일에 en 같은 값이 남아 있어도 플레이어가 고른 게 아닐 수 있어요. 그래서 "직접 골랐을 때만" 저장된 언어를 선택으로 인정하고, 아니면 기기 언어를 따라가요.

문장은 번역하고, 숫자와 날짜는 코드가 맞춰요

게임 코드는 한국어 문장을 키로 써요. t('한국어 원문')처럼 부르면 현재 언어의 사전에서 번역을 찾아요. 언어마다 파일이 하나씩 있어요(i18n-en.ts, i18n-ja.ts … i18n-vi.ts). 번역이 없으면 영어, 영어도 없으면 한국어 순으로 내려가요.

번역하는 사람이 지켜야 할 규칙은 이래요.

  • 한국어 원문을 보고, 영어를 참고로 곁에 둬요. 영어가 의도한 뜻과 말투를 보여 주니까요.
  • {n} 같은 자리표시자는 글자 하나도 바꾸지 않아요.
  • 게임 이름은 브랜드 이름이라 라틴 글자 그대로 둬요. 용어집에 현지 제목이 있을 때만 예외예요.
  • 게임마다 용어집(GLOSSARY.md)을 만들어 "부품", "적", "재화" 같은 말이 모든 화면에서 같은 단어가 되게 해요.

숫자와 날짜는 번역 대상이 아니에요. Intl.NumberFormat과 Intl.DateTimeFormat이 언어에 맞게 써 줘요. 코드에서 단어와 숫자를 이어 붙이지 않는 것도 원칙이에요.

복수형은 되도록 피해요. "공: 6" 같은 라벨 방식이면 복수형이 필요 없거든요. 꼭 필요한 문장만 {n:one|other} 형식으로 쓰고, 영어·스페인어·포르투갈어·독일어·프랑스어에서만 허용해요. 일본어, 중국어, 태국어, 베트남어, 인도네시아어에는 복수형 자체가 없어요. 이 규칙은 테스트가 검사해요.

번역하지 않고 "그리는" 것들

글자가 이미지에 박혀 있으면 번역 파일로는 바꿀 수 없어요. 타이틀 로고, 커버 그림, 문자가 들어간 AI 그림이 그래요. 그래서 팀의 규칙은 둘 중 하나예요.

  • 언어마다 이미지를 따로 만든다.
  • 글자 없는 이미지로 만들고 제목은 코드로 그린다.

아래 화면은 프레임 브레이커의 홈이에요. 같은 판 위에서 제목 글자와 버튼 이름이 언어마다 달라지는 걸 볼 수 있어요. 한국어에서는 큰 한글 제목 아래에 영문 FRAME BREAKER가 한 줄 더 붙고, 영어와 태국어에서는 라틴 제목이 그 자리를 차지해요.

한국어 프레임 브레이커 홈 화면. 위쪽에 한글 제목, 아래에 시작하기 버튼과 공방, 오늘의 판, 도감 버튼이 보여요
한국어 프레임 브레이커 홈 화면. 위쪽에 한글 제목, 아래에 시작하기 버튼과 공방, 오늘의 판, 도감 버튼이 보여요
태국어 프레임 브레이커 홈 화면. 시작 버튼과 하단 세 버튼이 태국 문자로 쓰여 있어요
태국어 프레임 브레이커 홈 화면. 시작 버튼과 하단 세 버튼이 태국 문자로 쓰여 있어요

한국어의 "오늘의 판"은 영어로는 "Daily Run"이고, 베트남어에서는 "Thử thách ngày"예요. 하나의 이름이 언어마다 길이가 크게 달라요. 같은 키가 여러 화면에서 쓰이면 가장 좁은 곳에 맞춰서 판단해요. 실제로 오늘의 계약이라는 키가 메뉴 이름과 제목 두 곳에서 쓰였는데, 베트남어 "Hợp đồng hằng ngày"는 메뉴에서 줄이 꺾여서 더 짧은 "Hợp đồng ngày"로 바꿨어요.

베트남어 프레임 브레이커 홈 화면. 하단 버튼에 Xưởng, Thử thách ngày, Bộ sưu tập이 보여요
베트남어 프레임 브레이커 홈 화면. 하단 버튼에 Xưởng, Thử thách ngày, Bộ sưu tập이 보여요

폰트: 글자가 "있는지"가 먼저예요

번역이 끝나도 화면에 글자가 안 나올 수 있어요. 규칙은 하나예요. 언어마다, 그 언어가 화면에 쓰는 모든 글자가 들어 있는 폰트를 쓴다. 단어 중간에서 슬쩍 다른 시스템 폰트로 바뀌면 안 돼요. 특히 베트남어 악센트와 태국어 부호에서 가장 먼저 깨져요.

게임 하나가 쓰는 글자는 많지 않아서, 폰트는 쓰는 글자만 남기는 서브셋으로 줄여요. 도구(pyftsubset)가 사전을 읽어서 필요한 글자만 담은 WOFF2 파일을 만들어요. 목표는 언어당 150KB 이하예요. 첫 번째로 적용한 프레임 브레이커의 실제 크기는 이래요.

언어선택한 폰트서브셋 크기
일본어M PLUS Rounded 1c ExtraBold72KB
중국어 간체ZCOOL KuaiLe45KB
중국어 번체Huninn89KB
태국어Mitr Medium13KB
라틴 계열(es, pt-BR, de, fr, id, vi)Baloo 2 Bold20KB (여섯 언어가 한 파일 공유)

한국어와 영어는 원래 쓰던 Jua 서브셋을 그대로 써요. Jua에는 악센트 글자가 없어서 스페인어·프랑스어·베트남어는 Baloo 2로 넘어가요.

몇 가지는 직접 겪고 나서야 알았어요.

  • 태국어와 베트남어는 줄 높이를 1.4~1.5 정도로 잡아야 쌓인 부호가 잘리지 않아요. 높이가 고정된 상자에서 line-height: 1을 쓰면 태국어 숫자가 잘렸어요.
  • 폰트에 따라 숫자 모양이 달라요. 어떤 폰트는 숫자를 기울여 그리고, 어떤 폰트는 0에 줄을 그어요. 그래서 그 언어 스택 맨 앞에 둥근 라틴 폰트(Fredoka)를 두고 숫자만 맞춰요.
  • 화면에는 한 언어의 폰트만 불러와요. 다른 언어 폰트를 미리 내려받게 하면 모두가 쓸데없는 데이터를 받게 돼요.
  • 일본어에 한국어용 글꼴 목록을 쓰면 안 돼요. 한국 시스템 글꼴에는 한자가 있어서, 한자만 한국식 모양으로 나오고 가나는 다른 폰트로 나올 수 있거든요.

글자가 넘치는지 기계로 찾아요

눈으로만 찾으면 12개 언어 × 여러 화면을 다 못 봐요. 그래서 npm run shots:i18n이라는 명령이 헤드리스 브라우저로 모든 화면 × 12개 언어 × 3가지 크기를 찍어요. 크기는 375×667, 360×526(주소창이 있는 안드로이드), 1280×720이에요.

자동 보고서는 이런 걸 잡아요.

  • 글자 상자가 칸 밖으로 튀어나온 경우(scrollWidth > clientWidth)
  • 캔버스에 그리는 글자가 한계까지 줄어든 경우
  • 그 언어의 폰트가 실제로 로드되지 않은 경우
  • 칸 안의 글자는 맞는데 칸 자체가 부모 밖으로 나온 경우(포르투갈어 "Configurações" 버튼이 데스크톱 패널에서 삐져나온 적이 있어요)

언어 12개를 나란히 붙인 대조표 이미지도 만들어서 사람이 직접 열어 봐요. 가장 좁은 360×526 이미지는 전부 보는 게 규칙이에요. "전부 보라"고 했는데 주요 흐름만 연 적이 있어서, 어떤 이미지를 열었는지 목록으로 남기게 했어요.

배포 뒤에도 한 번 더 확인해요. 폰트 파일(.woff2)이 실제로 200으로 내려오는지 curl로 확인하고, 일본어와 태국어에서 document.fonts.check()가 참인지도 검사해요. 파일이 빠졌는데도 브라우저가 시스템 폰트로 대신 그려서 스크린샷만으로는 멀쩡해 보인 일이 있었거든요.

자주 터지는 레이아웃 문제와 처방

증상처방
버튼 글자가 …로 잘림한국어·영어 외에는 두 줄로 접히게 허용
독일어 긴 낱말(Sicherheitsnetz)이 넘침hyphens: auto + 올바른 lang, 마지막 수단은 overflow-wrap: anywhere
일본어 복합어가 어색한 곳에서 꺾임꺾일 자리에 보이지 않는 공백(U+200B) 삽입
태국어는 띄어쓰기가 없어서 캔버스에서 줄바꿈 불가Intl.Segmenter('th')로 단어 단위로 나눔
"3-3" 같은 규칙 이름이 하이픈 뒤에서 꺾임숫자 사이를 줄바꿈 없는 하이픈(U+2011)으로 연결
여러 항목을 , 로 이음일본어·중국어는 、를 쓰는 함수로 이음

핵심은 하나예요. 글자가 안 맞으면 번역을 줄이기보다 화면이 양보해야 해요. 버튼 이름은 영어 길이 + 30% 안쪽으로 짧게 쓰되, 그래도 안 줄어드는 단어가 있으면 레이아웃을 바꿔요.

정리

  • 제이월드 팀은 2026년 10월 22일부터 모든 게임을 한국어·영어·일본어·중국어 간체/번체·스페인어·포르투갈어(브라질)·독일어·프랑스어·인도네시아어·태국어·베트남어, 12개 언어로 내요.
  • 언어는 저장된 선택 → 플랫폼 언어 → 브라우저 언어 목록 → 영어 순으로 정하고, 12개 밖의 언어는 건너뛰어요.
  • 문장은 한국어 원문을 키로 번역하고, 숫자·날짜·복수형은 Intl이 처리해요. 이미지 속 글자는 언어별로 따로 만들거나 코드로 그려요.
  • 폰트는 언어마다 필요한 글자만 담은 서브셋으로 만들고, 한 번에 한 언어만 불러와요.
  • 모든 화면 × 12개 언어 × 3가지 크기를 자동으로 찍어 넘침을 잡고, 배포 뒤에는 폰트 파일이 실제로 내려오는지 확인해요.

12개 언어를 한 번에 써 보고 싶다면 프레임 브레이커의 설정에서 언어를 바꿔 보세요. 웹에서 바로 플레이할 수 있어요.

이 글은 제이월드 팀이 게임 설계 문서와 실제 플레이 수치를 바탕으로 썼고, 글을 다듬을 때 AI 도구를 함께 썼어요.

다른 글

서버 없이 만드는 "오늘의 판": 날짜 하나로 모두에게 같은 판을 주는 법

프레임 브레이커의 오늘의 판이 서버 없이 어떻게 모두에게 같은 공과 벽돌을 주는지, 점수 공식과 연속 기록의 시계 함정 처리, 이모지 결과 공유까지 개발 노트로 풀었어요.

개발 노트데일리프레임 브레이커

조선의 봉수: 불과 연기로 소식을 이은 신호망, 그리고 화차 성채의 '봉화 단계'

봉수가 낮과 밤에 어떻게 신호를 보냈는지, 불 몇 개가 무슨 뜻이었는지 정리했어요. 화차 성채의 봉화 0~5단계 규칙이 역사와 어디서 갈라지는지도 표로 보여줘요.

culture봉수화차 성채

한판 AI 도전 공략: 오목·장기 상대 20명, 레벨마다 뭐가 달라질까

한판의 AI 도전 레벨 1~10을 구간별로 나눠, 상대가 어떻게 두는지와 별 3개 조건, 막혔을 때 쓸 수 있는 방법을 게임 속 문구 그대로 정리했어요.

공략한판오목

계정 없이 저장하기: 제이월드 게임이 진행 상황을 기기에 지키는 방법

로그인 없이도 진행이 사라지지 않게 하려고 제이월드 팀이 쓰는 저장 규칙을 정리했어요. 저장 형식, 버전 번호, 깨진 저장 복구, 기기 사이 옮기기까지 담았어요.

dev저장설계