RPG MV/MZ 실시간 번역기 1.10 (루나와 음욕의 함정 던전, 젬마4)

브라우저만 있으면 되는 설치방법이 생겼으니 최신 글 참조하세요

https://kone.gg/s/somisoft/dOFkO-asEVSKn6SfNnPz0b

Gemma 4 성능이 너무 좋아서 사용하도록 업데이트했습니다.
그래픽카드 16기가 이상인 분들은 gemma-4-26b-a4b 꼭 사용하세요

8기가면 gemma-4-e4b 이거도 퀄리티 나쁘지 않음

젬마로 바꾸고 초반 크래시나는거 해결만 했는데 이제 겜 하러감
+ 음욕치 미터 사라져버리는거 급히 패치함

1.10 음욕치 텍스트 0/100 이거 사라지는 문제 고침

1.11 - 영어 게임 지원

겜 끝까지 다 해봤는데 잘 되는데 딱 하나

트랩 하나가 미친듯이 텍스트를 뿜어내는데 deepl 쓰는 분들은 사용량 조심

게임별로 예외처리하고 그런식의 땜빵 처방은 안하니까 어쩔 수 없을 것 같음

1

1

왼쪽 스텟은 이미지라 불가능
설치가이드 (바뀐거 없음)

https://kone.gg/s/somisoft/dO6Vv7XQZNQ21ZG_IrdPWb?p=1&

딸깍 설치 웹사이트 오픈: https://nt7011.github.io

깃허브

https://github.com/nt7011/RPG-Maker-Live-Translator

GitHub - nt7011/RPG-Maker-Live-Translator: Translate RPG Maker MV/MZ games in real time

Translate RPG Maker MV/MZ games in real time. Contribute to nt7011/RPG-Maker-Live-Translator development by creating an account on GitHub.

### 개요

화면에 출력되는 모든 텍스트를 번역해 주는 RPG Maker MV / MZ용 애드온입니다. 지원하는 번역 엔진은 DeepL(사용자 개인 API 키 필요)과 로컬 LLM입니다.

RPG Maker는 스크립트 기반 플랫폼이기 때문에, 어떤 번역 방식이라도 모든 게임에 완벽하게 작동할 수는 없습니다. 따라서 많은 게임에서 미세한 오류가 발생하거나 아예 작동하지 않을 가능성이 있으며, 이 경우 직접 디버깅이 필요할 수 있습니다.


### 구현 방식

* 화면에 그려지는 온갖 종류의 텍스트를 감지하고 그 내용을 읽어옵니다.

* 비동기 방식으로 번역을 요청합니다.

* 번역 결과가 도착하면 기존 텍스트를 지웁니다.

* 동일한 과정이 무한 반복되지 않도록, 보이지 않는 유니코드 워터마크를 포함하여 해당 위치에 번역문을 그려 넣습니다.

* 이 애드온은 게임 로직에 어떠한 영향도 주지 않아야 합니다.

* 번역 결과는 디스크에 캐시됩니다.


### 사전 준비 사항

* 게임이 Enigma Virtual Box로 패킹되어 있다면, 먼저 압축을 풀어야 합니다.

* (일부 게임 필수) 게임에 포함된 nw.js 라이브러리를 업데이트하세요. 모든 RPGMV/MZ 게임에는 nwjs가 포함되어 있지만, 버전이 너무 낮아 이 애드온과 호환되지 않는 경우가 있습니다. [https://nwjs.io/downloads/](https://nwjs.io/downloads/)에서 파일을 다운로드하여 `Game.exe`가 있는 게임 디렉토리에 압축을 푼 뒤, `nwjs.exe`의 이름을 `Game.exe`로 변경하세요.


### 설치 안내 (설치 프로그램 이용 시)

1. 모든 파일을 다운로드한 후, `live-translator-installer/` 폴더를 게임 폴더(`Game.exe`가 있는 곳)에 복사합니다.

2. `live-translator-installer/installer.ps1` 파일을 우클릭하여 [PowerShell에서 실행]을 선택합니다. 만약 차단된다면, PowerShell 콘솔을 관리자 권한으로 열고 `Set-ExecutionPolicy Bypass -Scope LocalMachine` 명령어를 입력하세요. 잘 모르겠다면 ChatGPT에게 물어보세요.

3. `js/plugins/` 또는 `www/js/plugins/` 경로로 이동하여 `live-translator-installer/translator.json` 파일을 수정합니다.

* **DeepL 사용 시:** `"provider": "deepl"`로 설정하고, `settings.deepl.language`를 구성한 뒤 `settings.deepl.apiKey`에 API 키를 붙여넣으세요.

* **OpenAI 호환 API(예: LM Studio) 사용 시:** `"provider": "local"`로 설정하고 프롬프트를 수정하세요.

* *주의: 설치 폴더 내의 파일들은 아직 활성화된 상태가 아닙니다!*


### 설치 안내 (수동 설치 시)

1. `live-translator-installer/live-translator-loader.js` 파일을 `js/plugins/` 폴더로 복사하고, `plugins.js`에 해당 항목을 추가합니다.

2. `live-translator-installer` 폴더 전체를 `js/plugins/` 폴더로 복사합니다.

3. `package.json`을 확인하여 `name` 필드가 비어 있지 않은지 확인합니다.

4. `js/plugins/` 또는 `www/js/plugins/` 경로로 이동하여 `live-translator-installer/translator.json` 파일을 수정합니다. (DeepL 및 로컬 API 설정 방식은 위와 동일합니다.)

* *주의: 설치 폴더 내의 파일들은 아직 활성화된 상태가 아닙니다!*


### 개발 환경 및 문제 해결 (권장 사항)

* VSCode용 nwjs debugger 플러그인을 설치하세요: [https://marketplace.visualstudio.com/items?itemName=ruakr.vsc-nwjs](https://marketplace.visualstudio.com/items?itemName=ruakr.vsc-nwjs)

* 게임 파일을 `experimentation/` 폴더 안에 넣으세요.

* 포함된 `launch.json` 설정을 사용하여 nwjs 디버깅 세션을 실행하세요.

* 여러분이 선호하는 'vibecodingpromaster™' 소프트웨어를 준비하세요. 이 2,000줄짜리 난잡한 코드를 원시인처럼 일일이 수동으로 디버깅하고 있지는 않을 테니까요.

* 중국어, 일본어, 한국어 이외의 언어를 번역하려면 `settings.json`에서 `"disableCjkFilter": true`로 설정하세요.


### 변경 이력 (Changelog)

* **1.0** - 대규모 리팩토링 - 성능 및 정확도 개선 등

* **1.1** - DeepL 429 오류 수정, 설치 프로그램이 `plugins.json` 인코딩을 망가뜨리던 문제 수정

* **1.7** - Gemma 4로 모델 교체 및 게임별 크래시 현상 수정