kone
소미소프트

소미소프트

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

11/15/2025, 20:33:13
유틸
22789 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
그거 고치려다가 고치면 딴게 부서지고 잘 안되서 플레이하는데는 대충 괜찮길래 일단 포기함...
[복구]섹타듀벨리 모드팩
유틸
continuereset
05/26 5111 20
FORTUNE BRIDE ~절정개안의 의식~ 노모 패치
유틸
미스터장
05/24 6469 33
(코이카츠) 엔드필드 프리셋 공유
유틸
pst0025
05/23 8894 65
EnigmaVBUnpacker (MV MZ 언팩) 웹버전 오픈
유틸
mrpls
05/23 4320 15
[패치만] 시니시스타2 따거 MOD
유틸
하우두유두
05/22 14085 50
[노모패치] 갓 딴 임신시키기 좋은 날
유틸
나나바
05/21 9853 39
시니시스타 2 업뎃기념 모드 모음
유틸
sims9876
05/16 20920 105
(코이카츠) 버튜버 프리셋 공유 ver.2
유틸
pst0025
05/16 13330 51
(코이카츠) 버튜버 프리셋 공유 (복구)
유틸
pst0025
05/16 14799 64
WebP_Converter 코네 다운로드하다 WebP 불편해서 만든 프로그램
유틸
noname
05/15 13225 16
(코이카츠) 최근에 풀린 프리셋 공유
유틸
pst0025
05/15 12770 34
[RPG Maker MV/MZ 실시간 번역기] 4.0 출시
유틸
mrpls
05/15 22718 70
내가 쓰려고 만든 동음 정리 유틸
유틸
yeppi
05/15 8260 24
Texture Tool for Unity 6 ( Mono / IL2CPP ) v0.1.1 최초 배포 버전
유틸
argoklarke
05/14 15272 28
(코이카츠) 학원마스 프리셋 공유
유틸
pst0025
05/14 15675 43
(코이카츠) 프리셋 공유
유틸
pst0025
05/14 11568 58
QW1wbGVjdGVk 블렌더 파일 공유 첫번째 9.74GB
유틸
hannanas
05/12 15629 21
이미지 다운로더 만들어봄
유틸
lordofcinder
05/11 7857 34
코캇 명조 히유키 프리셋 2종류
유틸
pst0025
05/09 15979 24
(코이카츠) 씬 카드 공유
유틸
pst0025
05/09 9180 44
시니시스타2 안대 금발녀 모드 1.2.1 ver
유틸
cascastu
05/08 14502 37
자동소미 해적판X2 1.0.4업데이트 알림
유틸
스눕제이크
05/07 6558 18
[★추천] 무료 망가 번역기★
유틸
mybest
05/07 27864 127
(코이카츠) 소전 캐릭 2명 프리셋
유틸
pst0025
05/06 6914 21
(코이카츠) 명조 신캐 둘 프리셋
유틸
pst0025
05/06 6453 37
Unity Texture Changer v1.0
유틸
kumarin
05/05 7586 34
(코이카츠) 버튜버 프리셋 공유
유틸
pst0025
05/05 17140 79
염월선행록 translation-cache.log 5월10일자 갱신 마지막
유틸
보바도사
05/04 8854 39
배덕의 달콤함에 물든 마나카 FansChat 마개조 및 번역 모드 WIP Manaka
유틸
sco0815
05/04 12164 57
파일 구글 or LM 번역기) AI_kr_tr_9.pyw, AI_kr_tr_8.pyw
유틸
ㅇㅇ
05/03 11527 20