Repository navigation
V0.4.0-beta
Pre-release
Pre-release
·
2 commits
to main
since this release
v0.4.0 변경사항
KiriKiri 지원 추가
- KAG
.ks와 지원되는 비암호화 KAGEX PSB v2.scn을 번역합니다. 게임 폴더와 지원되는 ISO9660·Joliet 이미지를 읽으며, CLI에서는 ISO 파일을 직접 지정할 수 있습니다. - 대사·이름표·선택지·장면 제목을 옮깁니다. 내부 캐릭터 ID, 음성 파일명, 분기 목적지와 장면 번호는 보존합니다. 대사는 한국어만 표시합니다.
- 대화창·대사 기록의 한글 글꼴과 글자 폭 계산을 보정합니다. 인식 가능한 네이티브 메뉴, 설정·확인 팝업, 저장·불러오기, 정렬 및 장면 선택 화면도 번역합니다. 이미지 버튼은 원본과 일치하는 교체 이미지가 있을 때 적용하며, 버튼 상태·크기·클릭 영역을 유지합니다.
- 자동으로 표시명이 채워지는 KAGEX 이름도 추출합니다.
charvoice의 기본 이름을 참고하고, 기존 프로젝트에는 누락된 표시명만 추가해 이미 확정한 이름과 대사 캐시를 재사용합니다. - 확인된 루비 독음은 번역에 참고하고 한국어 본문에서는 제거합니다. 줄바꿈·기능 코드와 KAGEX에서 특별한 의미를 갖는 문자도 해당 형식에 맞게 처리합니다.
patch*.xp3를 게임 EXE 옆에 복사하는 방식으로 적용합니다. 게임의 패치 검색 방식에 맞춰 파일을 배치하고 이름 충돌을 검사합니다. 기존 패치의 경로만 고치는 경우 번역 없이 재포장할 수 있습니다.- 일본어 로켈이 필요하다고 확인된 지원 x86 게임에는
Play-Korean.exe를 생성합니다. 게임별 적용 방법은 결과 폴더의APPLY.txt에 표시합니다. - 재개·재번역·인명 보정·미번역 복구·정적 패치 검사를 지원합니다. 검사는 XP3와 시나리오 구조, 패치 경로 및 제어 값 보존을 확인합니다. 암호화·MDF 압축·미지원 구조의 SCN은 처리 범위에서 제외됩니다.
Unity 지원 추가
- Windows Unity 빌드의
resources.assets에서 구조를 확인할 수 있는 언어별 TextAsset을 번역합니다. 지원되는 키·값, 평면 JSON·CSV, 줄 기반 대사 형식과 확인 가능한 영어 기본 대사도 처리합니다. - 선택한 원문 언어 슬롯에 한국어를 넣습니다. 결과의
APPLY.txt에 따라 번역 에셋을 같은 빌드의*_Data아래에 복사하고, 게임에서 해당 언어를 선택하면 한국어가 표시됩니다. - 에셋의 키·구분자·변수·제어 태그와 다른 직렬화 객체를 보존합니다. 안전하게 삽입할 수 없는 항목은 원문을 사용하고 확인할 수 있도록 남깁니다.
- 수치가 같은 숫자·한글 표기를 허용하고, 값이 달라진 것으로 확인되면 최종 검토에 표시합니다. 응답 번호가 생략돼도 단건 응답의 대상이 명확하면 저장된 답안을 복구에 활용합니다.
- 별도 재번역, 미번역 복구, 정적 패치 검사를 지원합니다. 지원 범위는 확인 가능한 TextAsset이며 Unity Localization String Table, Addressables, 이미지에 들어 있는 글자, 코드 문자열은 제외됩니다.
RPG Maker MV/MZ 개선
- 같은 문자열이 화면 문구와 게임 동작용 식별자에 함께 사용될 때, 표시 위치만 번역하도록 추출·적용·검사를 보완했습니다. 기존 프로젝트에서 이 때문에 빠진 선택지와 표시 문구도 찾아 추가합니다.
- 다국어 게임에서는 선택한 원문 언어와 실제 요청에 사용한 언어표·기본 문구의 출처를 확인할 수 있습니다. 언어 선택을 바꿔도 기존 캐시의 원문 기록은 보존합니다.
- 대사 첫 줄이 확인된 인물 이름이면 이름표와 본문을 따로 처리한 뒤 합칩니다. 확인된 이름을 캐릭터 DB·화자 표시·대화 문맥에서 재사용합니다.
- 색상·글자 크기 같은 시각 서식은 모델에 보내기 전에 분리하고, 대응 위치를 확인할 수 있으면 다시 붙입니다. 변수·아이콘 등 기능 코드는 보호합니다. 직접 확정한 대사의 줄바꿈도 자동 보정으로 바뀌지 않도록 했습니다.
- 존재하지 않는 직업을 가리키는 캐릭터 데이터와 경험치 매개변수 이상을 정적 검사에서 찾습니다. 프로젝트에 보정할 직업 ID를 명시한 경우에만 해당 참조를 수정할 수 있습니다.
- 최신 결과 폴더를 선택해 패치 검사를 실행하면 실제 내보낸 파일을 읽습니다. 패치에 포함되지 않은 데이터는 준비 단계에 저장한 원본 사본과 대조합니다.
- 미번역 복구만 실행했을 때 아직 번역을 시도하지 않은 항목이 남아 있으면 복구분을 먼저 저장하고 패치 생성·검사를 보류합니다. 이전 결과는 그대로 사용할 수 있습니다.
Ren’Py 개선
- 패치 검사에서 번역 파일로 옮겨진 대사의 이미지 속성 오류를 원본 대사 위치까지 대조합니다. 원본에 같은 오류가 있는 경우에는 원본 경고로 분류합니다.
- 확정한 인명 표기를 화자명과 이름 입력 기본값에 반영합니다. 최종 검토에서 직접 입력한 대사는 자동 치환·조사·원문 병기를 거치지 않고 그대로 출력하며, 패키지 검사도 같은 값을 기준으로 확인합니다.
이름 확인과 미번역 복구
- 번역 전 이름 확인을 Ren’Py·RPG Maker·KiriKiri에 추가했습니다. 확인이 필요한 이름은 원문과 자동 제안을 나란히 볼 수 있습니다. 자동 처리된 이름도 접힌 목록을 펼쳐 수정할 수 있으며, 원어 유지와 직접 입력을 지원합니다.
- 일본어 인명은 확인된 가나·로마자 등 읽기 자료를 참고합니다. 쓰기만으로 독음이 불명확한 이름은 직접 확인할 수 있습니다. 확정한 이름은 다음 작업에서 재사용하며 일본어 잔류 검사에도 반영합니다.
- 패치 생성 전 미번역 확인을 Ren’Py·RPG Maker·KiriKiri·Unity에 추가했습니다. 자동 복구 뒤 남은 원문 유지·부분 번역과 확인할 항목을 보여주고, 사용자가 적용한 항목만 저장합니다. Unity는 내보낼 때 원본 데이터 형식과 기능 코드를 확인합니다.
- 대화형 PowerShell CLI에서도 마지막 검토를 지원합니다. 항목 건너뛰기, 취소, 명령어 모양의 문자열 및 여러 줄 입력을 처리합니다.
- 번역·재번역·게임 업데이트 중 엔진이 지원하는 작업에 미번역 복구와 패치 검사를 함께 지정할 수 있습니다. 번역 → 복구 → 검사 순서로 연결하고, Ren’Py 기본 번역에 포함된 복구가 중복 실행되지 않도록 했습니다.
번역 문맥·응답 처리 개선
- 일본어 자동 번역에서 한국어가 없는 응답, 일부만 섞인 응답, 일본어가 많이 남은 응답을 구분합니다. 필요에 따라 잔류 구절을 보정하거나 실패 초안과 주변 원문을 뺀 전체 문장으로 재시도합니다.
- 기능 코드나 이름과 관계없는
っ/ッ/ッ만 남았을 때는 안전하게 정리합니다. 해석 가능한 숫자만의 발화는 스크립트로 변환해 수치를 확인합니다. 감탄사·의성어·말버릇도 한국어로 옮기도록 보완했습니다. - 일본어 번역을 재개할 때 Ren’Py·RPG Maker·KiriKiri는 저장된 자동 번역에서 잔류 문자를 확인하고 필요한 항목만 복구합니다. 저장된 정상 답안을 먼저 활용하며, 복구가 끝나지 않은 한국어 초안은 부분 번역으로 보존합니다.
- 영어 대사·선택지에서 원문이 남은 경우를 더 잘 찾도록 했습니다. 확인된 인명, URL, 파일 경로, 게임 동작용 식별자는 검사에서 구분합니다. 실패·부분 번역은 자동 용어 재사용에 반영하지 않습니다.
- Ren’Py·KiriKiri는 같은 장면에서 앞 최대 8개, 뒤 최대 4개, 추정 2,000토큰 이내의 주변 대사를 통째로 선별합니다. 번역 대상 사이에 필요한 문장과 TXT 지침도 함께 처리합니다. 정상적인 문맥 선별은 상세 기록에 남기고, 실제 요청 한도에 맞춘 조정은 화면에서 확인할 수 있습니다.
- 일본어 RPG Maker는 주변 문맥에 이미 확보한 한국어 번역을 사용할 수 있습니다. 중복 원문을 줄이고 잔류 교정에서는 실패한 초안과 주변 원문을 제외합니다.
- HY의 번호별 응답과 범용 모델의 항목별 JSON을 각각 검증합니다. 완료된 항목은 먼저 저장하고, 실패 항목만 필요에 따라 단건·평문으로 다시 요청합니다. 중복 응답 번호, 출력 한도, 기호 반복은 원인별로 처리합니다.
- 새 프로젝트의 기본 컨텍스트 창을 16,384토큰으로 맞췄습니다. 실제 실행에는 선택한 GPU 설정을 적용하며, 이전 일반 모델 프로젝트의 8K 값이 저장된 설정을 덮던 문제를 수정했습니다.
GPU와 모델 관리
- LIGHT·FULL 모두 Ollama 0.40.15의 공식 ROCm 백엔드를 포함합니다. 호환 Windows AMD 드라이버에서 장치가 인식되면 별도 런타임 설치 없이 ROCm을 우선 사용합니다. ROCm으로 실행할 수 없으면 확인된 Vulkan 경로로 전환합니다. NVIDIA는 CUDA를 사용합니다.
- AMD GPU의 전용 VRAM·사용률과 번역에 실제 사용 중인지 확인할 수 있습니다. 실행 전 계획과 실제 실행 백엔드를 구분하고, 최종 확인 화면에 GPU별 모델과 적용 설정을 표시합니다.
- 여러 GPU를 직접 선택하거나 모두 사용하면 장치별 모델과 동시 처리 수를 지정합니다. 컨텍스트 창·KV 캐시·TXT 문맥도 장치마다 조정할 수 있습니다. 장치별 설정은 연결을 해제해도 보관됩니다.
- NVIDIA와 AMD를 함께 사용해도 장치마다 별도 추론 서버를 실행합니다. 각 GPU는 자신의 전용 VRAM에 모델을 올리고, 먼저 끝난 GPU는 다음 번역 묶음을 처리합니다. 한쪽 서버가 실패하면 해당 GPU를 복구하는 동안 정상 GPU는 계속 작업합니다.
- Ollama의 구형·신형 모델 등록 형식과 실행 변형을 인식합니다. 내려받은 정상 파일은 등록 재시도에 재사용합니다. 모델 삭제 시 다른 모델이 공유하는 파일도 보존합니다.
- Gemma 4·Qwen3.5 계열의 대화 형식 호환성을 개선했습니다. 실제 GGUF 구조·크기·템플릿을 기준으로 신규·기존 등록을 보정하며 사용자가 지정한 템플릿은 보존합니다. 모델 선택 화면과 실행 요약에는 확인 가능한 모델명을 표시합니다.
서버 복구와 오류 제보
- 토큰 수 계산 중 연결이 끊겨도 서버 복구를 적용합니다. 토크나이저 API 자체가 지원되지 않으면 입력량 추정치를 사용합니다.
- 서버 재시작 뒤 정상 번역이 실제로 저장되면 연속 실패 횟수를 초기화합니다. 연속 재시도와 작업 전체의 누적 재시작 수를 따로 기록하며, 다중 GPU에서는 복구가 필요한 장치의 설정을 유지합니다.
token repeat limit reached만 발생한 경우 해당 항목을 재시도합니다. CUDA 오류나 추론 서버 종료가 확인되면 서버 복구를 진행합니다. 반복 출력 때문에 끊긴 응답은 출력 한도만 계속 늘리지 않도록 했습니다.- 오류 기록에 실제 모델의 양자화·템플릿, 요청 설정, 반복 출력 특성, 응답 종료 이유, 장치별 서버 정보를 추가했습니다.
- 번역 완료·부분 번역·원문 유지·기존 번역 재사용을 따로 집계합니다. 복구 가능한 경고는 완료·실패 화면에서 유형별로 모아 발생 횟수와 관련 항목 수를 확인하고 복사할 수 있습니다.
- 작업을 중단시키는 오류는 별도 팝업에 표시합니다. 오류 내용 복사하고 닫기로 클립보드 복사가 성공하면 닫힙니다. 복사문과 진단 JSON에는 오류 ID·예외 유형 등 기술 정보를 남기고, 개인 경로·이메일·사용자 지정 모델명·게임 대사와 번역문은 제외합니다.
- 오류를 제보할 때는 복사한 내용을 반드시 함께 붙여넣어 주세요. 오류 ID와 실행 정보가 있어야 어느 단계에서 실패했는지 확인할 수 있습니다.
버그 수정
작업 순서와 패치 검사
- 번역·미번역 복구·패치 검사를 함께 선택했을 때 번역이 빠지거나 복구가 먼저 실행되던 문제를 수정했습니다. 선택한 작업을 번역 → 복구 → 검사 순서로 실행하며, Ren’Py의 기본 복구가 중복 실행되지 않도록 했습니다.
- RPG Maker에서 미번역 복구만 실행했는데 아직 번역을 시도하지 않은 항목이 남아 있으면, 복구분을 저장하고 새 패치 생성과 검사를 보류합니다. 이전 결과는 계속 사용할 수 있습니다.
- RPG Maker에서 결과 폴더를 골라도 내부 작업본만 검사해 실제 배포 파일의 손상·누락을 놓치던 문제를 수정했습니다. 선택한 최신 결과 폴더의 파일을 직접 검사합니다.
- Ren’Py에서 원본에도 있던 대사 이미지 속성 오류를 번역 패치의 결함으로 분류하던 문제를 수정했습니다. 원본 대사 위치와 오류 내용이 일치하면 원본 경고로 표시합니다.
- Ren’Py·RPG Maker에서 직접 확정한 대사가 자동 치환이나 줄바꿈 보정으로 바뀌던 문제를 수정했습니다. Ren’Py에서 정상적으로 반영된 수동 번역을 패키지 검사에서 오래된 결과로 오인하던 문제도 수정했습니다.
번역 누락과 응답 처리
- 일본어 잔류 검사와 복구의 기준이 달라 한자만 남은 대사가 복구에서 빠지던 문제를 수정했습니다. 확인된 인명·기능 코드와 본문에 남은 일본어를 구분합니다.
- 일본어만 나온 실패 답안이 다음 요청에 다시 들어가 같은 결과를 반복하는 경우를 줄였습니다. 정상 한국어가 있는 일부 잔류는 구절을 보정하고, 전체 재시도가 필요하면 실패 초안과 주변 원문을 제외합니다.
っ/ッ/ッ만 남아 정상 한국어 문장 전체가 버려지던 경우를 보정했습니다. 안전하게 지울 수 있는 문자는 정리하고, 해결되지 않은 한국어 초안은 부분 번역으로 남깁니다.- 이전에 통과한 번역이 더 최근의 실패 기록에 가려지던 경우, 검증을 통과한 저장 답안을 복구할 수 있도록 했습니다.
- 범용 모델의 재시도 지시와 JSON 응답 검사가 충돌해 답안이 누락되는 경우를 줄였습니다. 처음에는 항목별 JSON 형식을 맞추고, 필요한 실패 항목만 단건 평문으로 재시도합니다.
- 출력 한도로 끊긴 답안 중 완료된 항목은 먼저 저장합니다. 숫자나 기호의 반복이 원인인 응답은 출력 한도를 계속 늘리지 않도록 수정했습니다.
- 영어 대사·선택지가 영어 그대로 나오거나 영어로 다시 쓰였는데도 성공으로 처리되던 경우를 보정했습니다. 확인된 이름·URL·파일 경로·기능용 식별자는 구분합니다.
- 주변 원문이 과도하게 붙거나 번역 대상이 문맥에 중복되던 문제를 줄였습니다. 정상적인 문맥 선별은 상세 기록에 남겨
Context budget adjusted가 반복 표시되는 경우를 줄였습니다.
엔진별 표시와 데이터
- RPG Maker에서 선택지·설명이 내부 식별자와 같은 문자열이라는 이유로 추출에서 빠지던 문제를 수정했습니다. 반대로 화면 문구를 번역하면서 같은 이름의 플러그인 키까지 바뀌는 경로도 수정했습니다.
- RPG Maker에서 인명 표기가 본문에 섞이거나, 복구 중 이름이 다시 바뀌거나, 정상 원어 인명이 미번역으로 판정되던 경우를 보정했습니다. 저장 답안을 복원할 때 화면 좌표와 제어 코드가 중복되는 문제도 수정했습니다.
- RPG Maker에서 캐릭터가 없는 직업을 참조하거나 직업의 경험치 데이터가 잘못돼
expParams오류가 발생할 수 있는 경우를 검사합니다. 원본 문제는 경고로 표시하며, 보정할 직업 ID를 명시한 참조만 수정합니다. - KiriKiri에서 이름 확인 기록이 없는 기존 SCN 프로젝트가 캐시를 읽거나 패치를 다시 만들 때 실패하던 문제를 수정했습니다. 기본 표시명 슬롯이 누락되거나 같은 메뉴 문구가 중복 처리되는 경우도 보정했습니다.
- KiriKiri에서 XP3 내부 경로가 게임의 검색 규칙과 달라 패치 적용 후에도 일본어가 나오거나, 기존 패치를 다시 읽을 때 같은 시나리오를 두 번 추출하던 문제를 보정했습니다.
- KiriKiri에서 글자 폭과 줄바꿈 계산이 어긋나 한글이 붙어 보이는 경우를 보완했습니다. 원문 구조로 복원할 수 있는 줄바꿈은 모델을 다시 호출하지 않고 복구하며, 구형 루비 처리가 남은 캐시는 해당 항목만 재처리합니다.
- Unity에서 메뉴만 한국어로 바뀌고 확인 가능한 영어 기본 대사가 누락되던 문제를 수정했습니다. 기존 프로젝트에서도 해당 대사만 추가해 기존 번역을 재사용합니다.
- Unity에서 같은 수치의 숫자·한글 표기를 실패로 처리하거나, HY 단건 응답에서 번호가 빠져 대상이 명확한 답안까지 거부되던 문제를 보정했습니다. 데이터 형식에 맞지 않는 항목이 있으면 해당 항목만 원문으로 남기고 주변의 정상 번역은 출력합니다.
모델 등록과 GPU 실행
- 일반 GGUF의 다운로드가 끝나고 Ollama의
/api/create가 성공해도 신형 등록 파일을 못 찾아 설치 실패로 표시하던 문제를 수정했습니다. 정상적으로 받은 파일을 등록 재시도에 재사용합니다. - 모델을 삭제할 때 다른 모델이 공유하는 가중치나 구성 파일까지 지워질 수 있던 경로를 수정했습니다.
- Gemma 4 모델의 크기·대화 형식을 잘못 고르거나 Qwen3.5의 대화 형식을 놓치던 문제를 개선했습니다. 확인 가능한 모델명이 내부 해시 ID로 표시되거나 양자화 표기가 잘못 나오는 경우도 수정했습니다.
- 이전 프로젝트의 8K 설정이나 기본 초기화 값이 사용자가 저장한 컨텍스트·동시 처리 설정을 덮던 문제를 수정했습니다. 실행 전 화면과 로그에서 실제 적용된 설정을 확인할 수 있습니다.
- 한 GPU의 토크나이저가 준비되는 동안 다른 GPU도 입력 계산을 기다리던 병목을 줄였습니다. AMD는 실행 전 계획과 추론 서버가 실제로 사용한 백엔드를 구분해 표시합니다.
서버 복구와 오류 안내
- 번역 직전 토큰 수 계산에서 연결이 끊기거나 HTTP 500이 발생하면 서버 복구를 건너뛰던 문제를 수정했습니다. 토크나이저 API 미지원은 토큰 추정으로 처리합니다.
- HTTP 500의
token repeat limit reached가 서버 장애로 처리되던 경우를 수정했습니다. 이 경우 해당 번역 항목을 재시도하며, 확인된 CUDA 오류나 서버 종료는 서버 복구 경로로 처리합니다. - HTTP 응답 성공, 원문 유지 저장, 이전 서버의 늦은 응답이 연속 장애 횟수를 초기화하던 문제를 수정했습니다. 재시작한 서버에서 검증된 번역이 실제로 저장됐을 때 초기화합니다.
- 진행 이벤트가 도착할 때 경고가 사라지거나, 이미 복구된 항목이 완료 경고에 남던 문제를 보완했습니다. 부분 번역과 원문 유지도 별도로 집계합니다.
- 작업을 중단시키는 오류의 제보 팝업은 복사에 성공해야 닫힙니다. 상세 보고서를 만들 수 없는 상황에도 최소 기술 정보를 복사할 수 있으며, 개인 경로·이메일·사용자 지정 모델명은 제보 자료에서 제외합니다.
- 배포 검사에 공식 ROCm 파일의 누락·변경·추가 검사를 넣고, 실험용 MI50 구성요소가 분할 ZIP에 섞이지 않도록 했습니다.
배포와 다운로드
- 두 배포본에 공식 ROCm 런타임을 포함하고, 공식 파일 목록과 SHA-256을 확인한 뒤 분할 ZIP을 생성합니다. MI50 전용 실험 런타임, 개인 작업 자료, 게임 파일, 번역 캐시는 배포에서 제외했습니다.
- KiriKiri·Unity 사용법과 적용 범위를 문서에 추가했습니다. UnityPy 및 휴대용 일본어 로켈 구성의 제3자 고지도 포함했습니다.
| 배포본 | 포함 내용 | 받아야 할 파일 |
|---|---|---|
| LIGHT | 프로그램과 실행 환경. 번역 모델은 앱에서 받거나 직접 추가 | RenPyTranslator-light.zip + RenPyTranslator-light.z01 총 2개 |
| FULL | 프로그램과 실행 환경, HY-MT2-7B Q6_K 모델 | RenPyTranslator-full.zip + RenPyTranslator-full.z01~RenPyTranslator-full.z05 총 6개 |
선택한 배포본의 파일을 모두 같은 폴더에 받은 뒤, 반디집으로 .zip 파일을 열어 폴더 전체를 압축 해제하세요. Windows x64에서 압축을 푼 폴더의 RenPyTranslator.exe를 실행하면 됩니다.