크립터 (PGMMV)
문서 기준: AIMT PRO 1.15 계열
최종 편집 일시: 2026-06-22
이 도구는 무엇인가요?
크립터 (PGMMV)는 Pixel Game Maker MV 프로젝트의 Resources 파일을 복호화하거나, 작업 후 다시 암호화하는 보조 도구입니다. 화면에서는 복호화와 암호화 중 하나를 선택해 실행합니다. PGMMV 게임을 번역하려면 사실상 필수 과정입니다.
화면 참고 이미지
언제 사용하나요?
- PGMMV 프로젝트의
Resources가 암호화되어 있어 먼저 복호화해야 할 때 - 번역 적용이나 리소스 수정 후 원래 암호화 대상 파일을 다시 암호화해야 할 때
- PGMMV 작업 흐름에서 복호화, 추출, 번역, 적용, 암호화 순서를 정리해야 할 때
사용 전 확인할 것
- 현재 프로젝트가 PGMMV 계열인지 확인합니다.
- 프로젝트 안에
Resources와Resources/data/info.json이 있어야 합니다. - Decrypt는 원본
Resources를 백업한 뒤 현재 프로젝트의 파일을 제자리에서 복호화합니다. - Encrypt는 복호화 때 보관된 원본 백업을 기준으로, 원래 암호화되어 있던 파일만 다시 암호화합니다.
- 암호화 시 key type 선택이 필요하면 타입1 또는 타입2를 선택하는 창이 표시될 수 있습니다.
기본 사용 순서
- 작업 도구에서 크립터 (PGMMV)를 엽니다.
- 처리 모달에서 복호화 또는 암호화를 선택합니다.
- 복호화를 선택했다면 PGMMV 복호화가 시작되고,
Resources파일을 검사합니다. - 복호화 중 원본 파일은 백업 영역에 보관되고, 암호화된 파일은 현재 프로젝트 안에서 복호화됩니다.
- 번역 추출, 번역, 적용 등 필요한 작업을 진행합니다.
이후부터는 선택사항입니다. 꼭 필요할 경우에 진행해주세요. - 작업이 끝난 뒤 암호화를 선택해 원래 암호화되어 있던 파일을 다시 암호화합니다.
- key type 선택 창이 표시되면 프로젝트에 맞는 타입1 또는 타입2를 선택합니다.
- 완료 메시지에서 처리된 파일 수를 확인합니다.
화면/항목 설명
| 복호화 | 현재 PGMMV 프로젝트의 Resources를 검사하고, 암호화된 파일을 복호화합니다. 원본은 백업 영역에 보관됩니다. |
|---|---|
| 암호화 | 백업된 원본 Resources를 기준으로 원래 암호화되어 있던 파일만 다시 암호화합니다. |
| 타입1/타입2 | PGMMV 키 길이 또는 저장 방식이 애매할 때 암호화 기준을 직접 선택하는 옵션입니다. |
| 완료 메시지 | 복호화는 백업 수, 복호화 수, 평문 유지 수, 전체 파일 수를 표시합니다. 암호화는 다시 암호화한 파일 수를 표시합니다. |
| 처리 대상 | 현재 프로젝트의 Resources 아래 파일입니다. 임의의 외부 파일을 직접 골라 처리하는 도구가 아닙니다. |
결과 확인 방법
- 복호화 완료 메시지에서 복호화된 파일 수와 평문 유지 파일 수를 확인합니다.
- 복호화 후
Resources/data/project.json등 필요한 데이터 파일을 읽을 수 있는지 확인합니다. - 암호화 완료 메시지에서 다시 암호화한 파일 수를 확인합니다.
- 암호화 후 게임을 실행해 리소스 로딩 오류가 없는지 확인합니다.
- 암호화에서 암호화할 파일이 없다고 나오면 이미 암호화된 상태이거나, 복호화 백업 기준으로 다시 암호화할 대상이 없다는 뜻입니다.
주의/중요/권장
중요
복호화는 현재 프로젝트의 Resources를 제자리에서 복호화합니다. 실행 전 원본 보관 상태를 확인하고, 중간 작업본과 배포용 작업본을 구분하세요.
주의
암호화는 원본 백업을 기준으로 원래 암호화되어 있던 파일만 다시 암호화합니다. 복호화 백업이 없거나 현재 프로젝트 파일이 누락되어 있으면 실패할 수 있습니다.
권장
복호화 후 바로 추출과 적용을 진행하고, 최종 확인 직전에 Encrypt를 실행하는 흐름으로 관리하면 중간 상태를 파악하기 쉽습니다.
자주 헷갈리는 점
복호화는 파일을 새 폴더로 복사하나요?
아닙니다. 원본을 백업한 뒤 현재 프로젝트의 Resources 파일을 제자리에서 복호화합니다.
암호화는 모든 파일을 암호화하나요?
아닙니다. 복호화 때 보관된 원본 백업을 기준으로 원래 암호화되어 있던 파일만 다시 암호화합니다. 이미 암호화된 파일이나 원래 평문이었던 파일은 건너뛸 수 있습니다.
타입1과 타입2는 언제 선택하나요?
PGMMV 키 정보를 자동으로 확정하기 어려울 때 선택 창이 표시됩니다. 프로젝트에 맞는 key type을 선택해야 이후 암호화 결과가 정상적으로 열립니다.
암호화할 파일이 없다고 나오면 실패인가요?
항상 실패는 아닙니다. 다시 암호화할 대상이 없거나 이미 암호화된 상태일 수 있습니다. 작업 순서와 백업 상태를 확인하세요.