지원 엔진 · YU-RIS

완전 지원 — 재빌드 후 플레이 확인

YU-RIS 엔진 번역기 — raiL-soft JP 비주얼 노벨을 처음부터 끝까지 번역

YU-RIS(raiL-soft 제작)는 수백 개의 인디 및 상업 일본 비주얼 노벨을 만든 오래 이어져 온 Windows 스크립팅 엔진입니다. 그 리소스는 .ypf 패키지 아카이브에 들어 있고, 시나리오는 YSTB 스크립트(ysbin.ypf 안의 .ybn 파일, ysbin/yst00000.ybn 같은 내부 경로)로 컴파일됩니다. RuneTranslate는 .ypf 패키지를 순수 Rust로 읽고 — 외부 도구 없이 — 항목의 압축을 푼 다음, 컴파일된 YSTB 스크립트를 파싱합니다: 네 섹션(명령, 인수 디스크립터, 문자열 값, 줄 번호)을 나누고 자동으로 디코딩하며 따로 설정할 것이 없습니다. 거기서 문자열 테이블에서 일본어 대사를 뽑아내 모든 줄을 편집기에 나열하며, 엔진의 명령 피연산자, 변수 이름, 에셋 경로는 기본적으로 제외하여 스크립트 로직이 비교하는 대상을 절대 번역하지 않습니다. 내보내기 시 문자열 테이블을 다시 만들고 — 더 길거나 짧은 번역이 맞도록 모든 오프셋을 패치 — 같은 방식으로 다시 인코딩하고, 번역된 .ybn을 아카이브 경로에 느슨하게 씁니다. YU-RIS 런타임은 .ypf에 패킹된 동일 경로보다 디스크의 느슨한 파일을 우선해 읽으므로, 게임이 그냥 여러분의 번역을 불러옵니다 — 재패킹이 없습니다. 실제 타이틀에서 게임 안 확인을 거쳤지만 YU-RIS는 릴리스마다 다르니, 믿고 쓰기 전에 내보낸 빌드를 테스트하세요.

이 엔진을 위한 용어집 팁

비주얼 노벨은 고정된 등장인물과 반복 용어를 수천 줄에 걸쳐 활용하며, 기계 번역은 여주인공의 이름을 세 챕터에 걸쳐 세 가지로 표기합니다. 등장인물, 지명, 반복 용어를 미리 용어집에 넣어 모든 대사 줄이 동일하게 표시하도록 하세요.

용어집 기초

YU-RIS 번역하는 방법

  1. 단계 1

    YU-RIS 게임 폴더 열기

    게임 디렉터리 — 게임의 yu-ris.exe와 .ypf 패키지(보통 pac/ 하위 폴더에, 스크립트는 ysbin.ypf에 있음)가 있는 폴더 — 를 RuneTranslate로 지정하세요. 게임의 스크립트가 이미 풀려 있다면 느슨한 ysbin/ 폴더의 .ybn 스크립트도 감지됩니다. 엔진 감지가 YU-RIS 구조를 자동으로 인식하며, 원본 폴더는 절대 수정되지 않습니다.

  2. 단계 2

    .ypf 패키지를 읽고 YSTB 스크립트 디코딩

    RuneTranslate는 .ypf 패키지를 순수 Rust로 열고, 항목의 압축을 풀고, 안의 컴파일된 YSTB 스크립트를 파싱합니다. 각 스크립트를 따로 설정할 것 없이 자동으로 디코딩하고, Shift-JIS 문자열 테이블을 읽으며, 모든 일본어 줄을 스크립트 파일별로 묶어 편집기에 나열합니다. 엔진 명령 피연산자, 변수 이름, 에셋 경로는 표시되지만 기본적으로 제외되어 스토리 로직이 온전히 유지됩니다.

  3. 단계 3

    선호하는 제공업체로 번역

    이런 게임은 대사가 많고 어조에 민감하므로 LLM(OpenAI GPT-4o / Anthropic Claude)이나 DeepL이 대개 가장 잘 읽힙니다. 무료 Google Translate나 로컬 모델(Ollama / LM Studio)은 짧은 메뉴 문자열과 선택지를 담당하며, OpenAI 호환 제공업체를 OpenRouter나 NanoGPT로 연결할 수 있습니다. 선택적 AI 리파이너 2차 패스가 직역 표현을 다듬습니다.

  4. 단계 4

    인라인 제어 코드를 그대로 유지

    YU-RIS 메시지 텍스트는 백슬래시 제어 코드(줄바꿈, 색상, ruby)와 대괄호 태그를 대사에 엮습니다. RuneTranslate는 그 하나하나를 번역 중 숫자 자리 표시자로 고정하고 내보낼 때 복원하므로, 번역된 줄이 원본과 같은 서식과 페이싱을 유지합니다.

  5. 단계 5

    느슨한 파일 오버라이드로 내보내기(재패킹 없음)

    내보내기 시 RuneTranslate는 게임을 복사하고 각 번역된 YSTB 스크립트를 다시 만듭니다 — 문자열 테이블 오프셋을 패치해 어떤 길이의 번역이든 맞추고 같은 방식으로 다시 인코딩 — 그런 다음 원본 아카이브 경로(예: ysbin/yst00000.ybn)에 느슨하게 씁니다. YU-RIS 런타임은 .ypf에 패킹된 동일 경로보다 느슨한 파일을 우선하므로, 게임이 재패킹 없이 그냥 여러분의 번역을 읽습니다. 내보낸 복사본을 실행하면 여러분의 언어로 플레이됩니다.

지원 항목

  • 순수 Rust .ypf 패키지 리더(압축 해제 포함), 외부 도구나 사이드카 없음
  • 컴파일된 YSTB .ybn 시나리오 스크립트를 순수 Rust로 파싱(명령 / 디스크립터 / 문자열 테이블 / 줄 번호)
  • 컴파일된 YSTB 스크립트를 자동으로 디코딩, 따로 설정할 것 없음
  • 문자열 테이블에서 일본어 대사 추출; 명령 피연산자 / 변수 이름 / 에셋 경로는 기본 제외
  • 완전한 오프셋 패치로 문자열 테이블 재구성, 더 길거나 짧은 번역이 맞음
  • 느슨한 파일 오버라이드 내보내기 — 번역된 .ybn을 아카이브 경로에 놓음, 재패킹 불필요
  • DeepL, Google, OpenAI, Anthropic, OpenAI 호환, 로컬 모델을 통해 30개 이상 언어로 번역

제한 사항

  • 실제 타이틀에서 게임 안 확인을 거쳤지만 릴리스마다 다르니, 믿고 쓰기 전에 내보낸 빌드를 테스트하세요
  • YU-RIS 문자열은 Shift-JIS(cp932): 영어와 cp932로 표현 가능한 다른 대상은 작동하나, 비-cp932 스크립트(예: 확장 키릴 문자, 한국어, 번체 중국어)는 아직 자동화되지 않은 게임 폰트/인코딩 우회가 필요
  • 이미지에 새겨진 텍스트(타이틀 화면, 메뉴, 버튼)는 스크립트에 포함되지 않으며, 이미지 텍스트 OCR 흐름은 게임이 낱개 파일로 두는 이미지에만 닿고 .ypf에 패킹된 것에는 닿지 않습니다
  • YSCM 명령 테이블을 통한 명령별 메시지 태깅은 계획된 개선 사항. 현재는 시나리오 스크립트의 모든 일본어 문자열이 제공되며, 표시되지 않는 문자열은 휴리스틱으로 제외

관련 읽을거리

관련 읽을거리

문서

지원하는 다른 엔진