kone
소미소프트

소미소프트

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

11/15/2025, 20:33:13
유틸
22799 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
그거 고치려다가 고치면 딴게 부서지고 잘 안되서 플레이하는데는 대충 괜찮길래 일단 포기함...
예전에 했던 렌파이 겜 이름이 생각이 안남 도움!!
질문
westernp
05/17 3912 0
[복구요청] RJ176344 퇴마무녀유희
요청
konenne4235
05/17 3368 2
아아악!!!
일반
sosioto
05/17 4377 -1
사신상관 이 미친 샛기들 돈 벌기 존나 힘들어잉
일반
카라코람
05/17 4038 0
U2hhbXVNTUQ 작가 인생명작 가져옴,,!
영상
hannanas
05/17 26796 109
청아 / 블아) 히카리와 전철 안에서
영상
darkunicorn
05/17 38272 98
매드아일랜드 진짜 하고싶은거 하라고 던져주네 ㅋㅋㅋ
일반
fourdragonruler
05/17 4847 0
위태로운 시리즈 순서 질문좀요
질문
sh4882000
05/17 3781 0
[복구요청] NTR RPG시리즈 부탁드립니다
요청
sample098
05/17 4717 6
글씨가 어두워서 하나도 안보이네
일반
waybacx
05/17 4884 0
담달부터 노드 VPN질러야겠다.
일반
FGFFG0829
05/17 3874 1
[복구요청] RJ149951 풍기검사 아사기
요청
vessel
05/17 3412 1
직번) ※취향주의 [John K. Pe-ta] 도쿄 굉장해
동인
qlalfsla
05/17 25923 41
NTR불륜 vs 이종간함락순애
일반
jiska0
05/17 3679 0
VP세레나 이후로 뭔가 하나에 빡집중이 잘 안되네
일반
띠띠용
05/17 4116 0
[구매보급 겸 자막요청]네토라세 카운셀링~노노짱편~(5/25 업링크 갱신)
소리
albanom
05/17 18686 84
[복구요청] [요청복구] 메시아 오브 로리타 1.09 (26.04.13 )
요청
handrics
05/17 4567 0
던브 정령석에서 막혔는데 아시는분 ㅠㅠ
질문
fusbriwidhei32
05/17 1810 0
의술사 곧 9천장 팔게 생겼던데
일반
ashesone
05/17 4195 0
여성향 동인음성은 없나요..?
질문
소미소미
05/17 3498 0
[복구요청] 감옥용사 조이플 구동 패치파일 복구 부탁드립니다!
요청
y16963
05/17 3528 3
메르피어스 노크? 질문
질문
lliilili
05/17 2081 2
에뮬에서 BepinEx 폰트 투명인 새기들 봐라..
정보
o_o
05/17 3387 0
[세이브 요청] RJ388692 bloodroot 세이브 파일
요청
cbzlsk
05/17 4485 -2
존나 소신발언
일반
bansbes
05/17 6260 3
이미지로 작가 or 출처 찾는 사이트
정보
darkunicorn
05/17 7863 24
시니시스타2 엔딩봤다
일반
asfmasf
05/17 5733 0
명작이 괜히 명작이 아니야
일반
fantaj
05/17 9777 1
[복구요청]갈색 폭유 비서의 극음란 자지 아양 성처리~엘리트 사장 비서의 숨겨진 얼굴~
요청
selam
05/17 4817 0
비월선행록 오천문,분천역 오픈조건이 뭐지..
질문
보바도사
05/17 5049 -1