kone
소미소프트

소미소프트

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

11/15/2025, 20:33:13
유틸
22809 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
그거 고치려다가 고치면 딴게 부서지고 잘 안되서 플레이하는데는 대충 괜찮길래 일단 포기함...
던브 중층7층 어케가요?
질문
adash21
05/17 2737 0
리코의 이상한심부름 폰구동하는거 질문있어요
질문
iris1212
05/17 9652 1
아 쉬바 언홀메 모드하려다 세이브 날렸다
일반
ntr-masterpeace
05/17 4323 0
요즘 영상퀄들 지리네요..
일반
arghi
05/17 3218 0
나는 왜 ㅅㅂ 집는것마다 이러냐
야짤
5dk2io1
05/17 13529 53
급합 의술사 발간초 효과좀
질문
god4all
05/17 3589 -1
[구매보급][한국어 자막판]당신을 엄청 좋아하는 초변태 폭유 상사와 후배가 아양 떨며 마구 구애하는 알콩달콩 임신 하렘
소리
이름뭐하지
05/17 15964 130
인게임 스샷 단 하나! 뭘까 이 게임..
질문
lovemycookie
05/17 4145 0
크로네의 곁(クロネのとなり) 이거 레이패쳐 써서 기번해보려는데 막힘
질문
trswefft5
05/17 7274 0
[복구요청] [미번파일] RJ01219535 드래곤 블러드 2.12 dlc포함 1.03
요청
raybbit
05/17 4251 3
[구매보급/버전업] RJ01584572 여동생 H –짧은 하루– Ver1.0.2
번역
사과체스
05/17 39045 134
ntl 백합을 즐겨야 할 때는...
소리
gansik
05/17 13594 61
[복구요청] [번역] 착정 알라우네의 미지근한 촉수 코키로 오친포 시코시코 게임 (오나사포)
요청
tbvjxlah69
05/17 4956 0
[구매보급][미번] ダストロンガー RJ01615574 バレー部の可愛い後輩がセクハラ教師にNTRれる話
동인
riden
05/17 9349 9
님들 유부녀,밀프물 게임 추천점여
일반
hitomi
05/17 3098 0
[번역] 재미삼아 폐허에 갔다가 귀신이 붙은 JK
동인
마법우엉
05/17 24205 89
비월)방어구 강화,돌파
질문
ㅇㅁㄷㄱㅈㄷㄱㄷㅇ
05/17 2897 -2
[번역]사고 물건에서 며칠을 보내야 유령을 만날 수 있어!? 일주일 도전 방송
동인
마법우엉
05/17 22834 89
[번역]유령에게 만져지며 방송하는 스트리머
동인
마법우엉
05/17 18768 63
의술사 퀘 질문
질문
rummy
05/17 2900 -1
색귀는 하루만에 다깼는데
일반
코니아이
05/17 3647 0
와 쌰갈 ravager 존나 대격변했네
일반
kaelthas
05/17 3647 0
의술사 질문좀
질문
qazplm3444
05/17 3700 0
국산작가건 보면 바로 받아야겠네
일반
asdqweasdd
05/17 3725 0
[요청 복구] Succubus Temptation 2.0.0
복구
okviewer
05/17 25191 72
부계에 잠든 왕녀의 아바돈 치트 없음?
질문
sosiji
05/17 8328 -2
순애 펨돔같은 게임 있을까요
질문
sachunzzapagetti
05/17 2471 -1
[복구요청] RJ134905 退魔巫女物語+おまけ (퇴마무녀 이야기)
요청
konenne4235
05/17 5656 0
[버전업] [구매보급] RJ01214867 둘만의 생활_ver1.671 (26.05.05)
미번
gkqisq
05/17 11701 52
AI번역, Takurowo) 건방진 갸루를 서큐버스화 시켜서 혼내줬던 건 05
동인
sexe1
05/17 20761 117