마크 모드 튕김 · 오류 해결법 총정리

마크 모드 튕김은 대부분 버전 불일치, 선행 모드 누락, 모드끼리 충돌, 자바 버전 문제 넷 중 하나입니다. 무작정 다시 설치하기보다 게임이 남긴 로그를 먼저 보면 원인을 빨리 찾을 수 있습니다. 이 글은 로그 위치와 읽는 법, 원인별 해결법을 순서대로 정리했습니다.

exit code 1 뜻 (먼저 알아둘 것)

런처에 'exit code 1'이 뜨는 것은 게임이 오류로 종료됐다는 표시일 뿐, 원인 자체가 아닙니다. 실제 원인은 크래시 리포트나 로그 파일에 적혀 있습니다. 다른 숫자의 종료 코드가 떠도 마찬가지로 아래 순서대로 로그부터 확인하세요.

• 모드를 넣기 전에도 튕겼다면 그래픽 드라이버 업데이트, 백신·보안 프로그램 예외 설정을 먼저 확인합니다.
• 모드를 넣은 뒤부터 튕긴다면 이 글의 원인별 해결표로 바로 넘어가면 됩니다.

마크 크래시 리포트와 latest.log 위치

파일	위치	언제 생기나
크래시 리포트	crash-reports\crash-날짜-client.txt	게임이 오류를 감지하고 멈췄을 때
최근 로그	logs\latest.log	매번 실행할 때. 크래시 리포트가 없을 때 특히 중요
자바(JVM) 크래시	hs_err_pid숫자.log (게임 폴더 바로 안)	자바 자체가 멈췄을 때. 메모리 부족과 관련된 경우가 많음

모두 게임 폴더 기준입니다. 기본 게임 폴더는 윈도우 %appdata%\.minecraft, macOS ~/Library/Application Support/minecraft, 리눅스 ~/.minecraft입니다. 런처 프로필에 게임 디렉터리를 따로 지정했거나 CurseForge·Modrinth 앱을 쓴다면 그 인스턴스 폴더 안에 있습니다. 예전 로그는 날짜가 붙은 .log.gz 압축 파일로 남습니다.

마크 모드 오류 로그 읽는 법

로그는 길지만 볼 곳은 몇 군데뿐입니다. 메모장으로 열고 Ctrl + F로 찾으세요.

1. 크래시 리포트 맨 위: ---- Minecraft Crash Report ---- 아래 Description:과 그 밑의 첫 몇 줄에 원인이 요약됩니다. 여기에 나오는 모드 이름이나 모드 ID가 1순위 용의자입니다.
2. Caused by:: 오류가 여러 겹이면 마지막 Caused by: 줄이 진짜 원인에 가깝습니다.
3. -- System Details --: 실행에 쓰인 자바 버전, 메모리, 설치된 모드 목록이 있습니다. 내가 넣은 모드가 목록에 없다면 다른 게임 폴더로 실행됐을 수 있습니다. (모드 안에 포함된 하위 모듈이 함께 나열되는 것은 정상입니다)
4. latest.log: ERROR, FATAL, Exception을 검색해 처음 나오는 곳 주변을 봅니다.

단, 여러 모드가 얽힌 충돌이면 처음 이름이 나온 모드가 범인이 아닐 수도 있습니다. 직접 찾기 어렵다면 로그 파일을 그대로 모드 제작자의 이슈 페이지나 커뮤니티에 올려 도움을 받으세요. 긴 로그는 채팅에 붙여 넣기보다 로그 공유 사이트에 올려 링크로 전달하는 편이 읽기 쉽고, 사용자 이름 같은 개인 정보를 가려 주는 곳도 있습니다. 렉이 원인이라면 spark 같은 분석 모드의 결과를 함께 올리면 도움이 됩니다.

마크 모드 오류 원인별 해결법

원인	로그·화면 단서	해결
게임·로더 버전 불일치	특정 버전이 필요하다는(requires) 문구, 실행 직후 오류 창	모든 모드를 지금 게임 버전·로더용으로 다시 받기, 로더를 최신으로
선행 모드 누락	missing, 필수 의존성(dependencies)이 없다는 문구	오류에 적힌 모드(예: Fabric API)를 같은 버전으로 추가
중복 모드	Duplicate 문구, 같은 모드 두 개	버전만 다른 같은 모드는 하나만 남기기
모드끼리 충돌	Mixin과 함께 모드 이름, 특정 모드를 넣을 때만 튕김	최근 넣은 모드부터 빼 보기, 모드 페이지의 비호환 목록 확인
자바 버전 문제	UnsupportedClassVersionError, class file version	아래 표의 자바로 실행 (공식 런처는 자동)
메모리 부족	OutOfMemoryError, 큰 모드팩에서 로딩 중 멈춤	램 할당을 늘리기. 단, 실제 램의 절반 정도까지만
클라이언트 전용 모드를 서버에 넣음	서버만 켜지지 않고 화면·렌더링 관련 오류	서버 mods에서 Sodium, Iris, 미니맵 같은 화면용 모드 제거
옵티파인 충돌	옵티파인과 Sodium·Iris 등을 함께 넣음	둘 중 하나만 쓰기. 옵티파인이 그 게임 버전을 지원하는지도 확인

램은 많이 줄수록 좋은 것이 아닙니다. 너무 많이 주면 오히려 멈칫거림이 생길 수 있습니다. 적정값은 마크 램 할당 가이드를 보세요. 옵티파인은 이 글을 쓰는 시점에 26.x용이 미리보기(preview) 버전만 공식 다운로드 페이지에 올라와 있으므로, 옵티파인 가이드를 참고해 대안을 고르는 것도 방법입니다.

마크 자바 버전 오류 해결 (버전별 필요한 자바)

class file version 69.0처럼 숫자가 나오는 오류는 자바가 너무 낮다는 뜻입니다. 69.0은 자바 25, 65.0은 자바 21, 61.0은 자바 17을 가리킵니다. 마인크래프트 위키 기준 최소 자바 버전은 다음과 같습니다.

마인크래프트 버전	필요한 자바
26.1 이후 (26.1, 26.2, 26.3 …)	자바 25
1.20.5 ~ 1.21.11	자바 21
1.18 ~ 1.20.4	자바 17
1.17 ~ 1.17.1	자바 16
1.12 ~ 1.16.5	자바 8

공식 런처는 버전에 맞는 자바를 자동으로 씁니다. 프로필 설정에서 자바 경로를 직접 바꿨다면 기본값으로 되돌리세요. 다른 런처를 쓴다면 위 표에 맞는 자바를 Adoptium 등에서 받아 지정합니다. 반대로 1.12.2 같은 옛 버전 포지는 너무 높은 자바에서 실행하면 오류가 나는 경우가 있으니 자바 8을 지정하세요. 자세한 표는 마인크래프트 위키에서 확인할 수 있습니다.

원인을 모를 때: 모드 절반 빼기

로그로 범인을 못 찾았다면 모드를 반씩 나눠 확인하는 방법이 가장 확실합니다. 모드가 64개여도 6~7번이면 찾을 수 있습니다.

1. mods 폴더를 통째로 다른 곳에 복사해 백업합니다.
2. 선행 모드(라이브러리)는 남기고, 나머지 모드의 절반을 빼서 실행합니다.
3. 정상 실행되면 뺀 쪽에, 여전히 튕기면 남긴 쪽에 원인이 있습니다.
4. 원인이 있는 쪽을 다시 반으로 나눠 반복합니다.
5. 하나가 남으면 그 모드를 최신 파일로 바꾸거나, 함께 쓰면 안 되는 모드가 있는지 모드 페이지를 확인합니다.

뺄 때 선행 모드까지 빼면 다른 오류가 섞이니, 오류 문구가 바뀌면 그 점을 기준으로 다시 판단하세요.

런처별 확인 팁

• 공식 런처: 프로필의 게임 디렉터리가 모드를 넣은 폴더와 같은지 봅니다. 램 설정은 Installations 탭에서 프로필의 추가 옵션(More options) 안 JVM 인수에 있습니다.
• CurseForge 앱: 모드팩마다 폴더가 따로 있습니다. 모드팩 메뉴의 폴더 열기로 들어가 logs, crash-reports를 확인합니다.
• Modrinth 앱: 인스턴스마다 폴더가 따로 있고, 인스턴스 화면에서 로그를 볼 수 있습니다.
• Prism Launcher: 인스턴스 편집 화면에서 로그를 보고 자바 버전을 인스턴스별로 지정할 수 있습니다.

모드팩이라면 개별 모드를 건드리기 전에 모드팩 자체를 최신으로 업데이트하는 것이 먼저입니다. 모드팩 설치 가이드도 참고하세요.

자주 묻는 질문

마크 exit code 1은 어떻게 해결하나요?

exit code 1은 원인이 아니라 결과입니다. crash-reports 폴더의 최신 파일이나 logs\latest.log를 열어 맨 위 설명과 처음 나오는 모드 이름을 확인한 뒤, 위 원인별 해결표를 따라 하세요.

크래시 리포트 폴더가 비어 있어요.

게임이 크래시 리포트를 쓰기 전에 꺼진 경우입니다. 이때는 logs\latest.log와 게임 폴더의 hs_err_pid 파일을 확인하세요. 실행 직후 오류 창이 떴다면 그 창의 문구가 가장 중요한 단서입니다.

모드를 다 뺐는데도 튕겨요.

바닐라 프로필로도 튕기는지 먼저 확인합니다. 바닐라도 튕긴다면 그래픽 드라이버 업데이트, 프로필의 자바·JVM 인수 초기화를 해 보세요. 바닐라는 되는데 로더 프로필만 튕긴다면 로더를 다시 설치합니다.

마크 모드 오류 해결이 너무 어려워요. 처음부터 다시 해야 하나요?

새 게임 디렉터리로 프로필을 만들고, 꼭 필요한 모드만 몇 개씩 넣어 가며 실행하면 가장 깔끔합니다. 순서는 마크 모드 적용법을 따라 하면 됩니다.

정리

마크 크래시는 로그 확인 → 원인별 해결표 대조 → 자바 버전 확인 → 모드 절반 빼기 순서로 접근하면 대부분 해결됩니다. 로더 재설치는 포지 설치방법과 패브릭 적용방법을, 버벅임이 문제라면 마크 최적화 가이드와 최적화 모드 추천을 이어서 보세요.