kone
소미소프트

소미소프트

RPG MV/MZ 실시간 번역기 - 1.3

11/15/2025, 20:33:13
유틸
22935 views · 116 likes

이 글은 옛날 글이니 최신 글 참조하세요

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



































1.1 - DeepL 459 에러 긴급수정

`installer.ps1`이 `plugins.js` 인코딩 깨트리는거 방지

1.2 - diagnostics.log 보면 대부분의 문제 자가해결 가능

-> settings.json 누락 픽스.

1.3 - settings.json에 영어 등 한중일 아닌 언어용 옵션 (disableCjkFilter) 추가 - 이상한거 다 번역해서 API 엄청 낭비할 수 있으니 주의



업데이트한지 며칠 안되긴 했는데 고친게 역대급으로 많아서 배포해요

대충 쓸만한 정도는 된 것 같기도 하고


1



미러(그냥 위에 영상임 자료아님)


드디어 리팩터링을 마쳐서 정확성, 속도 등 많이 향상됨

콜레트 루프에 넣어보니까 수정 없이 99%는 잘 번역되는듯


설치방법이 살짝 바뀌었음. 파일이 여러개로 나눠져서 폴더를 복사해서 그 안에 ps1 스크립트를 실행하면 됨

예전에 쓰던 분들은 plugins.json에서 예전거 지우고 설치하면 될 듯

설치한 후에 설정 바꾸려면 js/ 폴더 들어가서 바꿔야 적용됨 아니면 다시 설치하거나


그리고 그래픽카드 VRAM 좀 높으면 (12기가도 더 작은 quantization 쓰면 가능할듯) mradermacher / YanoljaNEXT-Rosetta-27B-2511-i1-GGUF@iq3_m (16기가) 쓰셈

Context size 512나 256정도로 줄이고 Full Offload 하면 됨

퀄리티 딥엘보다도 훨신 나음



종말 얼터 에고이즘 에로스테는 문제가 좀 있긴 한데 게임 드랍해서 도저히 고치고싶지가 않음... ㅈㅅㅈㅅ

문제가 발생할 경우 diagnostics.log에 뭐라 쓰여있는지 보고 챗지피티한테 문의해본 다음 내용 포함해서 댓글써주세요~


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


Overview

RPG Maker MV / MZ용 애드온으로, 화면에 그려지는 모든 텍스트를 번역합니다. DeepL API 키는 직접 제공해야 합니다.

RPG Maker는 스크립트 기반 플랫폼이므로, 어떤 번역 구현도 모든 게임에서 완벽히 동작하지는 않습니다. 많은 게임에서 미묘한 문제들이 발생하거나, 직접 디버깅하지 않으면 전혀 작동하지 않을 수 있습니다.

Implementation

  1. 화면에 그려지는 모든 종류의 텍스트를 감지하고 내용을 읽습니다.

  2. 비동기적으로 번역을 요청합니다.

  3. 번역이 도착하면 해당 텍스트를 지웁니다.

  4. 과정을 반복하지 않도록 보이지 않는 유니코드 워터마크와 함께 번역된 텍스트를 제자리에 그립니다.

  • 이 애드온은 게임의 로직에 어떤 방식으로도 영향을 미치지 않습니다.

  • 사용자 정의 그리기 구현에 대비한 실패 방지용 비트맵 수준 감지가 있으며, 작동하지 않을 수도 있습니다. 문제가 있다면 비활성화하세요.

Prerequisites:

  1. 게임이 Enigma Virtual Box로 패킹되어 있다면 먼저 언팩하세요.

  2. (일부 게임에 필요) 게임에 포함된 nw.js 라이브러리를 업데이트하세요. RPGMV/MZ 게임은 모두 nwjs가 포함되어 있지만 매우 오래된 버전일 수 있으며, 이 애드온과 호환되지 않을 수 있습니다. https://nwjs.io/downloads/ 에서 최신 버전을 다운로드한 뒤, 모든 파일을 게임 폴더(Game.exe가 있는 곳)에 압축 해제하고 nwjs.exe의 이름을 Game.exe로 변경하세요.

Instructions (Installer):

  1. `live-translator-installer/` 폴더 전체를 게임 폴더(Game.exe가 있는 곳)에 복사하세요.

  2. `live-translator-installer/installer.ps1` 마우스 오른쪽 → Run with 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" 로 설정하고 언어를 지정하세요. 참고: installer 폴더 내 파일은 활성 상태가 아닙니다!

Instructions (Manual):

  1. `live-translator-installer/live-translator-loader.js`를 `js/plugins/` 폴더에 복사하고 `plugins.js`에 플러그인 항목을 추가하세요.

  2. `live-translator-installer` 폴더 내용물을 `js/plugins/live-translator` 폴더에 복사합니다.

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

  4. `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" 로 설정하고 언어를 지정하세요. 참고: installer 폴더 내 파일은 활성 상태가 아닙니다!

Dev Environment and Troubleshooting (Recommended):

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

  2. 게임을 `experimentation/` 폴더 안에 넣습니다.

  3. 포함된 `launch.json` 설정을 사용하여 nwjs 디버깅 세션을 실행합니다.

  4. vibecodingpromasterTM 같은 당신의 멋진 코드 편집기를 열어, 2000줄짜리 정체불명 스파게티 코드를 맨손으로 디버깅하는 원시인이 되지 않도록 하세요.



116
74 comments
뻑예
11/15/25
[캬루신나콘]
11/15/25
와 ㅅㅂ 고맙소!!
박수콘
11/15/25
끄으으응 난 왜 메뉴얼로 설치하면 번역이 안되고 (플러그인까진 로드 되는데 api 지워놔봐도 오류 안 뜸...) 인스톨러로 설치하면 Error LiveTranslatorConfig global not found. Ensure translator.json is loaded before translator.js. 이게 나오는 거지.
11/15/25
그게 결정적인 오류 아니면 저 두 설치법으로는 제대로된 로그를 볼 수가 없음 vscode 설치해야함 인스톨러로 했을땐 뭔가 더 심각한 설치 오류인듯
11/15/25
DeepL로 하는거면 "apiKey": "e5daa..........." 이렇게 따음표 써야함
11/15/25
와우 능력자네 ㄷㄷㄷㄷ
11/15/25
와우 능력자네 ㄷㄷㄷㄷ
11/15/25
혹시 실시간 번역되는게 보이는데 이게 영구적으로 번역되는건가요? 아니면 게임 껏다키면 다시 번역해야하는건지요?
11/15/25
없는거만 번역 받아오는거고 translation-cache.log에 영구적으로 저장됨 (최근 텍스트 2기가까지, 변경가능) {"in":"ニューゲーム","out":"새 게임"} {"in":"コンティニュー","out":"계속하기"} 이런식임
11/16/25
와... 미친.. 감사합니다
11/16/25
해외결제카드 없는데 제미니api키로 하고 싶으면 "provider": "deepl" 이것만 바꾸면 가능한가요.
11/16/25 Edited 11/16/25
지원안해요 직접 코드 고치셔야함 검열때문에 쓰기 힘들듯
11/16/25
Unexpected identifier 에러 뜨는데 왜 이런거임?
11/16/25 Edited 11/16/25
아마 .json 파일 잘못 편집했을듯 몰라유~
11/16/25
1.2로 돌려서 diagnostics.log 참조해주세요
11/16/25
와.... 너무 감사합니다
11/16/25
넘모 어려운것이여..
11/16/25
어떻게 결제해서 하는대 live-translator-installer/installer.ps1실행이후부터 SyntaxError Unexpected identifier에러 뜨는대 혹시 해결법 아시나요...
11/16/25
(작성자임) 무료로 API키 받은거 맞죠? 설명서대로 Nwjs 업그레이드하고 json파일 제대로 편집한게 맞는지 확인해보세요 (json은 긁어서 챗지피티한테 평가해달라고 하면 됨) 사용자용 오류 로깅을 업뎃학던가 해야겠네
11/16/25
1.2로 돌려서 diagnostics.log 참조해주세요
캬 이건 진짜 야무지네 ㅋㅋ
11/16/25
혹시 소악마 스마트폰 그 게임도 번역되려나... 몇 달동안 번역이 안되고 있는데 그렇게 뚫기 어려운 게임은 이런 툴로 잘 안되겠죠?
11/16/25
궁금해서 해봤는데 https://github.com/mos9527/evbunpack 이거로 언팩하고 nwjs 업뎃하면 되네요 https://litter.catbox.moe/t991fe.png
11/16/25
정말 감사합니다 ㅠㅠㅠㅠ 번역 해주시는분들도 이렇게 프로그램 만들어주시는것도 진짜 감사합니다
11/18/25 Edited 11/18/25
installer 실행해도 바로 꺼지는데 이유가 뭘까 Set-ExecutionPolicy Bypass -Scope LocalMachine 실행했고 MachinePolicy Undefined UserPolicy Undefined Process Undefined CurrentUser RemoteSigned LocalMachine Bypass 임 diagnostics.log는 어디서 확인함? 에러뜨는거 보니 unable to resolve game root di라고 뜨는 것 같은데
11/19/25
Diagnostics.log는 설치 끝난 후에 보는거고 game.exe 옆에 게임폴더자체를 복사하고 그 안에서 실행해야함. 가끔 언팩 안하면 설치불가능한 게임들도 있음
11/19/25 Edited 11/19/25

Deleted comment.

11/19/25
진짜 미안한데 또 에러가 떠 가지고. 제미나이한테 물어봐도 번역관련 확장 프로그램을 삭제하라는데 나는 확장프로그램으로 번역기를 깐게 없거든...
11/19/25
2025-11-19T10:32:13.102Z | ERROR | [LiveTranslatorLoader][Fatal] Missing or unreadable asset settings.json (expected in live-translator folder next to live-translator-loader.js). TypeError: Failed to fetch 2025-11-19T10:32:13.104Z | ERROR | [LiveTranslatorLoader] Failed while loading support assets: TypeError: Failed to fetch 2025-11-19T10:32:13.105Z | FATAL | [LiveTranslatorLoader]
11/19/25
Unhandled error during bootstrap | TypeError: Failed to fetch at chrome-extension://njgcanhfjdabfmnlmpmdedalocpafnhl/js/plugins/live-translator-loader.js:111:44 at Array.map (<anonymous>) at loadSupportFiles (chrome-extension://njgcanhfjdabfmnlmpmdedalocpafnhl/js/plugins/live-translator-loader.js:108:27) at bootstrap (chrome-extension://njgcanhfjdabfmnlmpmdedalocpafnhl/js/plugins/live-translator-loader.js:310:34)
11/19/25
js/plugins/live-translator 이 폴더에 settings.json이 없나봅니다
11/20/25
아... 원래 딸려있는건데 1.2 업데이트할때 누락되어버렸음 ㅈㅅㅈㅅ 고쳤음
11/20/25
이제 문제없이 잘 됨! 번거로웠을텐데 고마워.
11/20/25 Edited 11/20/25

Deleted comment.

11/20/25 Edited 11/20/25
나도 위에분이랑 같은 에러나옴. 언팩하고 nwjs 덮어씌우고 인스톨까지 문제없이 됐는데 js/plugins/live-translator 이 폴더안에 settings.json 생성이 안됨 다른 파일들은 다 있는거 같은데. 소악마 스마트폰으로 테스트함
11/20/25
아... 원래 딸려있는건데 1.2 업데이트할때 누락되어버렸음 ㅈㅅㅈㅅ
11/20/25
이지트랜스 지원하실 생각은 없음? 여기 사람들 대부분은 이지트랜스 다 깔려있을텐데
11/20/25
구려서...
11/20/25
누구든지 지원 추가하거나 포크 (긴빠이해서 내 버전도 출시한다) 가능한 라이선스니까 번역기에 내가 안쓰는 기능은 DeepL 정도 유지하는정도만 끝낼듯
11/25/25
고수
11/25/25 Edited 11/27/25

Deleted comment.

11/27/25
스테이터스 어디박혀있나 백날찾아보다 안나와서 포기한거 이걸로 간단하게번역해서 즐겜중입니다 감사합니다 감사합니다
11/27/25
api키 넣으면 Uncaught SyntaxError: Unexpected token ? 이렇게 뜨는데...이런 경우는 어떤경우일까요?
11/30/25
아무래도 API키 넣은 translator.json을 잘못 편집하신거같네요 , " 이런거 json 규격에 맞는지 봐주세요
11/30/25
[LiveTranslator][Config] settings.deepl.apiKey contains underscore; DeepL keys typically use hyphens. Verify the key. 키 입력을 정확하게 했는데 이 에러가 자꾸 뜨는데 왜 이럴까요
11/30/25
translator.json에 ___NONE___ 이거 잘 지우고 그 자리에 넣으신거맞나요 테스트해봤는데 키 안입력했을때 증상이고 키 입력하니까 되네요.
12/04/25
ps1 파워쉘로 실행시키면 순간 켜졌다가 바로 꺼져서 관리자권한에서 명령어를 입력한 후에도 꺼지는데 방법이 있을까요
12/05/25
ps1 파워쉘로 실행하는거에서 바로 꺼져가지고 PowerShell 관리자 권한으로 열어서 Set-ExecutionPolicy Bypass -Scope LocalMachine 까지 했는데도 계속 꺼지는데 혹시 방법 좀 알려줄 수 있음?
12/06/25
그거 원래 정상적이어도 꺼짐 고친다는거 또 깜빡했다 ㅈㅅ
12/06/25
잘되네 감사
12/21/25
번역 기능 진짜 좋네. 그런데 세이브 로드 같은건 글자가 일어랑 한글이 겹쳐지는 현상이 발생하던데 이건 원래 그런거야? 그리고 deepl은 무료api많이 사용하니까 api여러개 넣어서 50만자 다 쓰면 자동으로 api 바꾸는 기능이 들어가면 좋을거 같음
01/30
그거 고치려다가 고치면 딴게 부서지고 잘 안되서 플레이하는데는 대충 괜찮길래 일단 포기함...
[노모][Arai Kei] 반의 수수한 오타쿠에게 조건만남을 시켜보았다
동인
김덕배
05/20 25642 125
록시 번역기 후기
후기 및 공략
bruno00
05/20 3308 1
소와 양의 잡화 상점 이미지 번역 기록 -1-
작업현황
5dk2io1
05/20 5766 28
의술사) 내가 길치인건지 겜 길찾기가 좆같은건지 모르겠는데
질문
asdawer
05/20 1411 -1
동급생 소프 망가 제목 기억안나서 미치겠음
질문
여우
05/20 2209 0
비월선행록 1.289 개조버전 수정 알림
번역
V
05/20 27726 184
헬스장에서 레바테인과 함께 (엔드필드)
영상
브레머튼
05/20 15665 105
진짜 보자마자 벽 느껴지네
야짤
하이바라
05/20 7908 10
의술사 이거 피 계속 걸을때마다 10퍼씩 까지는데 왜이러는지 모르겟노
일반
nasang
05/20 4007 -1
[노모/오네쇼타] 누나 타임♥
동인
질겨찾기
05/20 23686 62
안돼 동거라이프 엔드리스 어캐함?
질문
공백
05/20 2224 0
[보추] 박아줘! 시스터♂ ~ 무자각 섹스 ~
동인
질겨찾기
05/20 17884 54
의술사 의수 어디서 얻나요?
질문
rummy
05/20 3774 0
[복구 요청] 딸한테 사정해서 가정붕괴
요청
kadinalpinter1
05/20 4836 1
역방향 이라마치오
야짤
toscana
05/20 5947 21
던전레기온 이거 어렵네? 생각보다?
일반
RED LOTUS
05/20 1975 0
언홀리메이든 같은 게임 있으면 추천 좀
질문
satam1212
05/20 2226 2
ntrpg2 막힘..
질문
january2000
05/20 2407 0
스샷 속 게임 제목 아시는 분 계신가요?
질문
belling
05/20 2966 0
의술사는 진짜 해보셈
일반
arknight
05/20 4150 0
(미번/번역요청/청아) wada wau - Todoke Mirai! Futari no Wish
동인
118cbvg
05/20 6213 10
렌파이 추천좀 해줘
일반
skywing16
05/20 3049 0
직번, 청아, 후타, 후여) [momomo] 언니들이 리나쨩에게 볼일이 있어서 집까지 와줬으면 좋겠어~♥ + 두개 더
동인
라비쉬
05/20 19589 66
스타메이커는 도대체 언제 뜨는거냐
일반
김상덕
05/20 2376 0
torobakoya 이사람 작품 번역 있나요?
질문
hihihoho
05/20 3181 0
(청아)[AI 번역][Nanao Yukiji] 조카의 여자친구를 훈육한 건 2~5화
동인
초보역식자
05/20 29115 134
언홀메 미모만 찍고있는데
질문
rlawnsdudrod
05/20 3888 2
모바일 미연시 추천 해주세요
질문
jdbvw
05/20 5213 0
[구매보급]쿨데레 만화 연구부 부장과 부실에서 몰래 오호 목소리 엄청 야한 교미부 활동
소리
이름뭐하지
05/20 8504 61
복구 2종
복구
햄댕이
05/20 32306 57