마인크래프트 모드팩 설치 실패 해결 가이드 — 런처·Java·다운로드 오류 차근차근 잡기
모드팩이 설치되지 않거나 켜자마자 종료되는 상황을 단계별로 진단하는 가이드. 런처별 흔한 오류, Java 버전 불일치, 다운로드 실패, 메모리 부족 같은 가장 자주 막히는 지점을 정리했습니다.
📑 목차 (9개 섹션)
시작하기 전에 — 어느 단계에서 막혔는지부터 파악하기
'설치가 안 된다'는 한 마디 안에 사실 네 단계의 문제가 섞여 있습니다. 어디서 막혔는지 정확히 짚어야 엉뚱한 곳에서 시간을 쓰지 않습니다.
C와 D의 차이가 헷갈리는데, 인스턴스 폴더 → crash-reports/에 새 파일이 생성되었는지로 구분합니다. 파일이 있으면 D, 없으면 C입니다.
1단계 — 런처별 흔한 문제
CurseForge 앱
모드팩 다운로드가 도중에 멈춤 받아야 할 모드 파일이 수백 개라 그중 하나가 실패해도 전체가 멈춘 것처럼 보입니다. 순서대로 시도하세요.
'Third Party Download' 안내가 뜨는 경우
모드 제작자가 CurseForge의 자동 배포를 꺼 둔 모드가 팩에 들어 있으면, 런처가 그 모드만 자동으로 받지 못합니다. 안내에 나온 모드 페이지에 직접 들어가 jar를 받은 뒤 인스턴스의 mods 폴더에 넣으면 됩니다. 설치 실패가 아니라 정상 동작이니 당황할 필요 없습니다.
인스턴스가 목록에 안 보이거나 생성이 실패 설치 경로 문제일 수 있습니다. 한글·특수문자가 없는 짧은 영문 경로로 바꾸고, 백신이 인스턴스 폴더를 차단하고 있지 않은지 확인하세요.
Prism Launcher (또는 ATLauncher)
Prism의 강점은 인스턴스를 직접 다루는 것입니다. 런처 안에서 CurseForge·Modrinth 모드팩을 검색해 설치할 수 있고, 이미 받아 둔 클라이언트용 모드팩 zip을 Import 할 수도 있습니다.
Java는 인스턴스별로 직접 지정합니다: 인스턴스 우클릭 → Edit → Settings → Java에서 마인크래프트 버전에 맞는 Java 경로를 잡아 줍니다.
2단계 — Java 버전 불일치
실행하자마자 창이 닫히는 케이스에서 가장 먼저 의심할 곳입니다. Java 버전이 낮으면 게임이 아예 시작되지 않고, 로그에 UnsupportedClassVersionError가 남습니다.
마인크래프트 버전별 Java
설치된 Java 확인
Windows: cmd 열고 java -version
Mac/Linux: 터미널에서 java -version
필요한 버전이 없으면 Adoptium(adoptium.net)이나 Azul Zulu에서 해당 JDK를 받아 설치합니다. CurseForge·Modrinth 앱은 모드팩이 요구하는 Java 런타임을 알아서 받아 쓰므로 대개 신경 쓸 필요가 없고, Prism처럼 직접 지정하는 런처에서만 수동 설정이 필요합니다.
3단계 — 메모리(RAM) 설정
Java가 맞는데도 즉시 종료된다면 메모리 설정을 보세요.
대략적인 기준
설정 위치
-Xmx8G -Xms8G 형식⚠️ 많이 줄수록 좋은 게 아닙니다. OS와 다른 프로그램이 쓸 메모리를 남겨 두세요. 16GB PC라면 8~10GB 선이 무난합니다. 남는 메모리가 없어 OS가 스왑을 시작하면 할당량과 무관하게 전체가 느려집니다. 자세한 내용은 [메모리·JVM 인수 가이드](/guides/memory-jvm-args-guide/)에 있습니다.
4단계 — 다운로드·네트워크 문제
'Failed to download' 또는 다운로드 중 멈춤의 흔한 원인:
5단계 — 수동 설치로 우회
런처 자동 설치가 계속 실패하면 수동 설치가 확실한 우회로입니다.
시간은 조금 더 걸리지만, 런처 자동 처리에서 막히던 단계를 건너뛸 수 있습니다.
미리 막는 습관
마무리
설치 실패는 대부분 어느 단계에서 막혔는지만 정확히 짚으면 풀립니다. 즉시 종료라면 Java와 메모리를, 로딩 중 크래시라면 crash-report를, 다운로드 실패라면 네트워크를 보세요. 그래도 안 되면 수동 zip 설치로 우회하는 게 정석입니다.
![Better MC [FORGE] BMC4 커버 이미지](/images/modpacks/bmc4-cover.png)