프로젝트 소개

이 저장소는 스타 시티즌을 위한 커뮤니티 현지화 프레임워크로, 자원봉사자들이 유지 관리하는 번역으로 게임 내 텍스트를 대체하거나 보완하는 것을 목표로 합니다. README는 게임 자산에서 기본 언어 팩을 추출하고, 구조화된 JSON으로 변환하고, 기여자가 편집하고, 검증한 후, 원본 게임 파일을 덮어쓰지 않고 런타임에 주입되는 델타 패치로 내보내는 파이프라인을 설명합니다. 문서화된 기능에는 동적 방언 감지(예: pt-BR 대 pt-PT), 함선 제조사 이름과 같은 고유 명사를 번역하지 않고 유지하는 설정 반영 용어집, 실시간 업데이트 스트림, 번역자를 위한 스크린샷과 버튼 ID가 포함된 상황별 메타데이터, 브라우저 기반 이중 창 비교 편집기, 누락된 문자열이 상위 언어를 상속하는 대체 체인, 아랍어와 히브리어를 위한 RTL 재배치가 포함됩니다. 호환성 매트릭스는 Windows를 네이티브, Linux를 Wine/Proton을 통한 수동 오버레이, macOS를 부분 지원, Steam Deck을 핸드헬드 UI 스케일링 프로필과 함께 검증됨으로 나열합니다. 구성은 primary, secondary 및 voice 언어, 자막, 로케일 지역, RTL 강제, 용어집 엄격성, 업데이트 채널 및 커뮤니티 재정의를 위한 필드가 있는 lang_profile.json 파일을 통해 처리됩니다. starlocale이라는 CLI가 inject, validate, status 및 export 모드로 문서화되어 있으며, 게임의 엔티티 시스템과 통신하는 내장 Lua 런타임을 사용하는 것으로 설명됩니다. 선택적 AI 지원은 OpenAI 및 Anthropic API용 Python 스니펫을 통해 표시되며, 시스템 프롬프트는 설정 일관성을 지시하고 컨텍스트 창은 선행 게임 내 대사를 제공합니다. API 키는 자리 표시자이며 통합은 명시적으로 선택 사항입니다. 커뮤니티 워크플로는 언어 패키지 청구, 웹 편집기에서 JSON 편집, 자동 검증을 통한 풀 리퀘스트 제출, 주간 델타 릴리스, 업데이트 채널을 통한 게임 내 채택을 다룹니다. README는 27개의 활성 언어 팩에 걸쳐 340명 이상의 자원봉사 번역자가 있으며 주요 언어의 경우 일반적인 처리 시간이 48시간 미만이라고 주장합니다. 이 프로젝트는 MIT 라이선스에 따라 릴리스되었으며, Cloud Imperium Games 또는 Roberts Space Industries와 제휴하지 않으며, 수정 사항은 사용자 자신의 책임하에 사용되며, 제거는 주입된 패치 디렉토리를 삭제하여 수행된다는 면책 조항이 포함되어 있습니다. 지원 채널에는 언어별 스타일 가이드가 있는 DOCS 폴더, 이슈 트래커, 온보딩을 위한 NEW_LOCALE_TEMPLATE 디렉토리, 열린 이슈를 중계하는 Discord 봇이 포함됩니다. README에는 또한 지원되는 언어와 키워드를 나열하는 SEO 지향 단락과 GitHub Pages URL을 가리키는 다운로드 배지가 포함되어 있습니다.