P+PLUSGAME

개발 기록 · 공통 언어 모듈

몽실팝에 한국어·영어 선택을 넣으며 지킨 다섯 가지

v0.8.3에 적용한 언어 모듈 시범의 실제 범위. 번역 파일 실패, 보호할 값, 버전 고정과 남아 있는 캔버스 문구를 기록합니다.

여러 게임의 언어 선택을 매번 새로 만들지 않도록 공통 모듈 1.0.0을 만들고 몽실팝 웹 v0.8.3에 먼저 연결했습니다. 목표는 모든 글자를 외부 번역 서비스에 보내는 것이 아니라, 선택과 저장의 동작을 예측 가능하게 만드는 것이었습니다.

공통 지침을 작성한 것과 게임 런타임에서 동작을 확인한 것은 다른 단계입니다. 이번 시범은 몽실팝 한 게임에만 적용됐습니다. 다른 PlusGame 게임이 자동으로 영문판이 됐다는 의미가 아닙니다.

1. 선택한 언어가 기기 언어보다 먼저

언어는 사용자가 저장한 선택, 지원하는 기기·브라우저 선호 언어, 영어 순서로 결정합니다. 홈에서 한국어와 영어를 다시 고를 수 있고 선택은 이 게임의 브라우저 저장소에 남습니다. 기기 언어가 한국어라고 사용자가 고른 영어를 매 실행마다 덮어쓰지 않는 것이 핵심입니다.

게임마다 출처와 저장소가 다르므로 선택값을 자동으로 모든 게임·기기에 복제하지 않습니다. 공통 규칙을 쓴다는 사실과 이용자가 같은 사람이라고 인증했다는 사실은 다릅니다. 언어 선택에 로그인이나 기기 지문 수집을 요구하지 않습니다.

2. 공통 문구와 게임 문구를 나누기

시작·닫기·설정·고객지원처럼 반복되는 문구는 공통 번역표에, 코스·친구·아이템 설명은 게임별 번역표에 둡니다. 이번 시범에서는 홈·설정·24개 코스·14친구·HTML HUD·정책·TEST 결제 문구를 연결했습니다.

닉네임·지원 코드·상품 ID 같은 값은 번역하지 않습니다. 제목도 임의로 기계 번역하기보다 등록된 이름을 유지합니다. 사용자에게 보이는 문구를 바꾸면서 결제 상품 키나 저장 ID를 바꾸지 않는 것이 기능 보존의 기준입니다.

3. 이미지와 캔버스는 자동으로 해결되지 않습니다

HTML 문구는 번역표로 바꿀 수 있지만 캔버스에 직접 그린 글자와 이미지·SVG 내부 글자는 이번 대상에서 제외했습니다. 따라서 한국어 그림이 일부 남을 수 있습니다. ‘완전 영문판’이라고 선언하는 대신 어디까지 바뀌는지 명시했습니다.

브라우저 자동 번역도 보조 수단입니다. 앱 웹뷰와 웹 브라우저의 번역 기능이 같지 않고, 게임이 새로 그린 문구를 브라우저가 놓칠 수 있기 때문입니다. 앞으로 언어를 늘리려면 번역표뿐 아니라 이미지·캔버스 문구의 처리 범위를 별도로 검토해야 합니다.

4. 번역이 실패해도 게임을 막지 않기

모듈과 번역표 버전을 고정하고 불러오기에 실패하면 원문을 남겨 게임을 계속 실행하도록 설계했습니다. 문구 하나가 등록되지 않았다고 화면 전체를 지우거나 게임 시작을 막지 않습니다. 언어 변경은 진행도·게임 재화·광고·구매 권리를 초기화할 이유가 없습니다.

웹 검증에서는 영어 선택과 새로고침 후 유지, 한국어 복귀, 번역 파일 404에서 원문 진행을 확인했습니다. 이는 브라우저 검증 기록이며 iPhone·Android 네이티브 앱 실기기 검증을 대체하지 않습니다. 반응형 미리보기의 실제 모바일 폭 확인도 별도 항목으로 남겼습니다.

5. 전체 게임 확대 전에 해야 할 일

다음 게임은 같은 모듈을 연결하더라도 해당 게임의 버튼·대사·에러·접근성 문구를 번역 키에 연결하는 초기 작업이 필요합니다. 번역 파일만 복사하고 모든 문구가 연결됐다고 완료 처리하지 않습니다. 아직 등록되지 않은 표현을 원문으로 남기는지, 핵심 선택 버튼이 읽히는지도 게임별로 확인해야 합니다.

번역표 변경과 기능 변경은 분리하고, 새 버전은 검증 뒤 게임별로 적용합니다. 공통 파일을 고쳤다는 이유로 모든 공개 게임에 확인 없이 최신 기능을 강제 적용하지 않습니다. 이번 결과는 한 게임의 언어 시범이며 전체 통합 계정·결제·스토어 출시 완료 보고가 아닙니다.

자주 묻는 질문

번역 API 비용이 매번 드나요?

이번 시범은 자체 번역표를 읽는 방식이며 외부 자동 번역 API를 호출하지 않습니다. 웹 파일 요청·호스팅 사용량과 번역표 작성·관리 비용은 별개입니다.

다른 게임도 지금 영어로 바뀌나요?

아닙니다. 현재 적용·웹 검증 대상은 몽실팝입니다. 다른 게임에는 각각 문구 연결과 회귀 검증이 필요합니다.

언어 변경으로 진행도가 지워지나요?

언어 선택은 게임별 설정이며 진행·상품 ID를 바꾸지 않습니다. 데이터가 사라졌다면 사이트 데이터를 삭제하지 말고 원래 기기와 버전을 고객지원에 알려주세요.

확인·수정 기록

  • — 언어 모듈 1.0.0의 몽실팝 공개 배포 기록과 브라우저 검증 결과를 근거로 작성했습니다. 캔버스·이미지와 네이티브 실기기 미검증 범위를 남겼습니다.

본문의 공략은 규칙에 근거한 플레이 제안입니다. 전체 기기·브라우저에서의 동작이나 온라인 상대의 연결을 보장하는 문서는 아닙니다. 화면이 다르거나 오류가 있다면 게임명·버전과 함께 알려주세요.