플러그인추가
문서 기준: AIMT PRO 1.15 계열
최종 편집 일시: 2026-06-22
이 도구는 무엇인가요?
플러그인추가는 AIMT가 제공하거나 사용자가 가져온 MVMZ용 플러그인 파일을 현재 프로젝트에 추가하는 도구입니다. 선택한 .js 파일을 프로젝트의 js/plugins 폴더에 복사하고, 필요한 경우 js/plugins.js의 플러그인 목록에도 등록합니다.
화면 참고 이미지
언제 사용하나요?
- MVMZ 프로젝트에 번역 보조용 플러그인을 추가해야 할 때
- 현재 프로젝트의
plugins.js에 플러그인 등록이 필요할 때 - 기존 플러그인 파일을 AIMT 플러그인 목록에서 골라 프로젝트에 복사하고 싶을 때
- 이미 등록된 플러그인을 교체할지 확인해야 할 때
번역을 하다보면 특정 플러그인들의 특정 위치를 수정해야할 때가 있습니다.
이런 경우 미리 수정해둔 플러그인을 가져와 담아두었다가 재활용하면 시간을 크게 절약할 수 있습니다.
단, 프로젝트에서 쓰고 있는 플러그인이 미리 고쳐둔 플러그인보다 버전이 높을 수도 있으니 항상 안전을 보장할 수는 없습니다.
사용 전 확인할 것
- 현재 프로젝트가 RPG Maker MV/MZ 계열인지 확인합니다.
- 프로젝트 안에
js폴더와plugins.js를 쓸 수 있어야 합니다. - 기존 플러그인과 이름이 같거나 이미 등록되어 있으면 덮어쓰기 확인이 표시될 수 있습니다.
- 플러그인 충돌 가능성이 있으므로 실행 전 프로젝트를 보관하세요.
충돌 비교엔 WinMerge 를 활용하게 됩니다. - 플러그인 추가 후에는 게임 실행으로 충돌이나 로딩 오류를 반드시 확인해야 합니다.
기본 사용 순서
- 작업 도구의 MVMZ 영역에서 Add Plugin을 엽니다.
- 표시되는 플러그인 목록에서 추가할
.js파일을 선택합니다. - 필요하면 플러그인 설명이나 도움말 내용을 확인합니다.
- 추가를 실행합니다.
- 이미 같은 파일이나 등록 정보가 있으면 덮어쓰기 여부를 선택합니다.
- 완료 메시지를 확인합니다.
- 프로젝트의
js/plugins와plugins.js에서 반영 여부를 확인합니다. - 게임을 실행해 플러그인 로딩 오류가 없는지 확인합니다.
화면/항목 설명
| 플러그인 목록 | AIMT가 사용할 수 있는 .js 플러그인 파일 목록입니다. |
|---|---|
| 도움말/정보 | 플러그인 파일의 설명 블록과 help 내용을 확인하는 영역입니다. |
| 추가 | 선택한 파일을 프로젝트 js/plugins 폴더에 복사하고 plugins.js에 등록합니다. |
| 덮어쓰기 확인 | 같은 파일이 있거나 이미 등록된 플러그인일 때 표시됩니다. |
| plugins.js 등록 | 플러그인 메타데이터를 읽어 프로젝트의 플러그인 목록에 추가합니다. |
주의/중요/권장
플러그인추가는 파일 복사와 plugins.js 수정을 함께 수행할 수 있습니다. 실행 전 프로젝트를 보관하세요.
같은 이름의 플러그인을 덮어쓰면 기존 플러그인 내용이 바뀔 수 있습니다. 덮어쓰기 전 대상이 맞는지 확인하세요.
플러그인을 추가한 직후에는 게임을 한 번 실행해 콘솔 오류와 플러그인 충돌 여부를 확인하세요.
새로 추가한 플러그인은 기존의 플러그인들보다 후미에 배치되며, 간혹 이 순서로 인해 의도치 않은 문제가 생기기도 합니다.
자주 헷갈리는 점
파일만 복사하나요?
아닙니다. 새 플러그인을 추가할 때는 파일 복사와 함께 plugins.js 등록도 시도합니다.
이미 등록된 플러그인은 어떻게 되나요?
이미 등록되어 있거나 파일이 존재하면 덮어쓰기 확인이 표시될 수 있습니다. 취소하면 변경하지 않습니다.
플러그인을 추가하면 바로 게임에 적용되나요?
프로젝트 파일에는 반영되지만, 실제 동작 여부는 게임 실행으로 확인해야 합니다. 기존 플러그인과 충돌할 수 있습니다.