Crash Assistant
크래시가 나면 관련 로그를 모아 보여 주고, 알려진 원인이면 해결 방법까지 안내하는 클라이언트 전용 진단 도구.
📖 소개
Crash Assistant는 KostromDan이 만든 크래시 진단 모드입니다. 핵심 한 줄 — 마인크래프트가 크래시된 뒤 GUI를 띄워, 관련된 게임·런처 로그와 크래시 리포트, hs_err 파일을 한 화면에 모아 보여 줍니다.
로그 분석 — 로그를 읽어 알려진 크래시 원인과 대조합니다. 일치하는 항목이 있으면 문제 설명과 구체적인 해결 방법을 담은 안내를 띄웁니다. 대조 대상은 상당히 넓습니다. 그래픽 드라이버 문제, 할당 메모리 부족(OutOfMemoryError), 모드가 너무 높은 Java 버전에서 도는 경우, 같은 모드가 중복 설치된 경우, Mixin 충돌, 의존성 누락, Forge/NeoForge 버전 불일치, 설정 파일 손상 등이 포함됩니다. 일부 항목에는 클릭 한 번으로 처리하는 자동 수정이 붙어 있습니다.
로그 공유 — 로그를 한 번의 클릭으로 업로드하고 링크를 복사할 수 있습니다. 드래그 앤 드롭으로 파일을 꺼낼 수도 있어, 모드 제작자나 모드팩 지원 채널에 문제를 보고할 때 시간이 줄어듭니다.
분석 도구 — GUI에서 몇 가지 도구를 함께 제공합니다. Create·Epic Fight의 설치된 버전과 호환되지 않는 애드온을 찾아 주는 검사, MCreator로 만든 모드 목록, 특정 자바 클래스나 패키지가 어느 모드에 들어 있는지 찾는 검색, 그리고 어떤 모드가 특정 클래스에 의존하는지 추적하는 도구입니다.
통합 그래픽 경고 — 더 강력한 외장 GPU가 있는데도 내장 GPU로 게임이 돌고 있으면 경고를 띄웁니다.
이 모드는 클라이언트 전용입니다. 서버에 넣어도 아무 일도 하지 않습니다.
🕒 이 모드는 언제 쓰는가
크래시가 났을 때만 쓰는 도구입니다. 평소에는 존재를 인식하지 못합니다.
📦 어떤 모드팩에서 중요한가
모드 수가 많아 크래시 원인을 좁히기 어려운 환경에서 가치가 큽니다.
🎮 플레이 체감 변화
크래시 이후의 '뭐부터 봐야 하지'가 사라집니다. 로그를 찾아 열고 검색하는 단계를 건너뛰고, 알려진 문제라면 해결책이 바로 나옵니다.
🚀 시작 가이드 — 첫 30분 동안 해야 할 것
설치되어 있으면 따로 할 일이 없습니다. 크래시가 나면 진단 화면이 뜨고, 거기에 이번 크래시의 로그가 모여 있습니다.
알려진 문제로 잡히면 해결 방법이 함께 나오니 그대로 따라 하면 되고, 잡히지 않으면 로그를 업로드해 링크를 만든 뒤 모드팩 지원 채널이나 모드의 GitHub Issues에 붙여 물어보는 게 가장 빠릅니다.
💡 플레이 팁
- 크래시 후 창을 닫지 마세요: 진단 GUI에 이번 크래시와 관련된 로그가 모여 있습니다.
- 알려진 문제면 해결책이 함께 나옵니다: 설명만 읽지 말고 안내된 조치를 따라 하세요. 일부 항목은 자동 수정 버튼이 있습니다.
- 로그 업로드 후 링크 공유: 도움을 요청할 때 로그 링크가 있으면 대화가 훨씬 빨리 진행됩니다.
- 클래스·패키지 검색 도구:
NoClassDefFoundError처럼 어느 모드가 원인인지 모를 때, 해당 클래스를 가진 모드를 직접 찾아볼 수 있습니다. - 내장 GPU 경고를 무시하지 마세요: 외장 GPU가 있는데 내장으로 돌고 있으면 성능과 안정성 모두 손해입니다.
⚠️ 자주 헷갈리는 부분
- • 크래시를 막아 주지는 않습니다: 이미 일어난 크래시를 설명하는 도구입니다. 크래시 빈도 자체는 줄지 않습니다.
- • 모든 크래시가 알려진 원인은 아닙니다: 대조에 걸리지 않는 크래시는 로그만 모아 보여 줍니다. 그때부터는 직접 읽어야 합니다.
- • 서버에서는 아무것도 하지 않습니다: 클라이언트 전용 모드입니다.
❓ 자주 묻는 질문
크래시를 막아 주나요?
아닙니다. 크래시가 난 뒤 원인을 찾도록 돕는 진단 도구입니다.
서버에도 넣어야 하나요?
아닙니다. 클라이언트 전용이며, 서버에서는 아무 일도 하지 않습니다.
어떤 크래시에 가장 도움이 되나요?
이미 알려진 원인에 해당하는 크래시입니다. 드라이버 문제, 메모리 부족, 모드 중복 설치, Mixin 충돌, 의존성 누락 같은 것들은 문제 설명과 해결 방법이 바로 나옵니다.
