Minecraft 1.20.1, 1.21.1용 Crash Assistant 모드

Minecraft가 충돌한 후 GUI를 표시하여 영향을 받은 모든 게임/런처 로그, 충돌 보고서 또는 hserr 파일을 즉시 보여줍니다. 이를 업로드하고, 링크를 복사하고, 기타 작업을 수행할 수 있는 원클릭 솔루션을 제공하여 보고, 디버깅, 문제 해결을 더 쉽게 만듭니다. 많은 알려진 충돌 원인에 대해 로그를 분석합니다. 다양한 유용한 분석 도구를 제공합니다. 전용 GPU가 사용 가능한데 Minecraft가 통합 GPU에서 실행 중이면 경고합니다. 많은 일반적인 문제에 대한 자동 수정을 포함합니다.

이 모드는 클라이언트 전용입니다. 서버에서는 아무것도 하지 않습니다.

질문이 있으시면 언제든지 제 Discord 서버에 참여해 주세요: https://discord.gg/dV8WFrJZK6

기능:

GUI:

드래그 앤 드롭을 지원합니다. GUI에서 파일을 원하는 곳으로 직접 이동할 수 있으며, “Available log files:” 라벨에서 드래그하여 모든 로그를 드래그 앤 드롭할 수 있습니다.

로그 분석:

많은 알려진 충돌 원인에 대해 로그를 분석합니다. 알려진 문제가 감지되면 문제 설명과 자세한 해결 방법이 담긴 대화 상자를 표시합니다.

지원되는 분석:

hserr (JVM 충돌):

• AlLibAlcCleanup (일부 RAM 할당 관련 저주받은 문제)
• atio6axx.dll (AMD 드라이버 문제)
• glfw.dll (일반적인 GPU 드라이버 문제)
• ig7icd64.dll (구형 Intel 통합 GPU 드라이버 문제)
• InsufficientMemory (시스템의 물리적 RAM 또는 스왑 공간이 부족함)
• JavaTooHigh (예: Java ≥ 22에서 Spark 모드 충돌)
• jemalloc.dll (jemalloc 메모리 할당자 문제)
• jvm.dll (잠재적인 하드웨어 문제 또는 JVM 자체의 버그)
• libglfw.so / libopenal.so (흔한 Linux 라이브러리 문제)
• libGLProgrammability.dylib (macOS에서 호환되지 않는 셰이더 팩)
• ~StubRoutines::SafeFetch32 (잘못된 JDK를 사용하는 Apple Silicon의 macOS)
• nglMultiDrawElementsBaseVertex / 0x0000 (GPU 드라이버 문제)
• nvoglv64.dll (Nvidia 드라이버 문제)

log / crash-report:

• ConnectorIncompatibleFabricMods (Sinytra Connector 사용 시 Sodium/Iris와 같은 호환되지 않는 Fabric 모드를 감지)
• Create6Addons (Create 버전과 애드온 간의 비호환성, 클릭 한 번으로 모든 호환되지 않는 모드를 찾을 수 있는 버튼을 제안)
• CtovWithoutLithostitched (ChoiceTheorem's Overhauled Village 모드에 필수 종속성이 누락됨)
• CurseForgeCorrupted (CurseForge 런처로 인한 손상된 Minecraft/로더 설치)
• DiskSpaceEnded (시스템의 디스크 공간이 부족함)
• DuplicatedMods (동일한 모드의 여러 버전이 설치됨)
• EpicFightAddons (Epic Fight 버전과 애드온 간의 비호환성, 클릭 한 번으로 모든 호환되지 않는 모드를 찾을 수 있는 버튼을 제안)
• FeatureOrderCycle (월드 생성 기능의 순환 의존성)
• FerriteCoreNeighborTable (모드가 FerriteCore의 이웃 테이블에 부적절하게 접근하는 경우 감지, 임시 설정 우회 방법 제공)
• GeckoLibOculusCompat (GeckoLib Oculus Compat 모드가 Minecraft 1.20.1+에서 더 이상 필요하지 않으며 충돌을 일으킨다고 경고)
• GroovyModLoaderIPv6 (IPv6 문제로 GML이 매핑을 다운로드하지 못함, 클릭 한 번으로 문제를 해결하거나 GML에 의존하는 모든 모드를 찾을 수 있는 자동 수정 포함)
• KubeJSDataPack (KubeJS로 데이터팩을 로드하는 중 오류)
• LanguageProviderMismatch (모드가 다른 버전의 Forge/NeoForge를 요구함)
• LegacyTooManyIds (1.12.2와 같은 구형 Minecraft 버전에서 블록/아이템 ID 한도를 초과함)
• MixinApply (Mixin 충돌 또는 오류로 인한 광범위한 충돌을 감지, 누락된 클래스 감지 및 누락된 클래스에 의존하는 모드를 찾는 자동 수정 포함)
• MissingEmbeddiumForOculus (Oculus 모드가 필수 종속성인 Embeddium 없이 설치됨)
• MissingIndium (모드가 Fabric Renderer API 호환성을 위해 Indium을 요구하지만 설치되지 않음)
• MissingUnsupportedDependencies (Forge/NeoForge에서 감지한 일반적인 종속성 충돌)
• ModernFixWatchDog (통합 서버가 교착 상태에 빠짐)
• NeoForgeVersion1201 (1.20.1의 Neo가 중단되었으며 많은 충돌을 일으킨다고 알리며, 해당 버전에서 Forge로 전환하는 것이 Neo의 공식 권장 사항임)
• ModuleFind / ModuleResolution (Java 모듈 시스템 오류, 종종 종속성 충돌로 인해 발생, 문제를 일으키는 모드를 즉시 식별, 이 문제를 찾으려면 우리 모드 없이는 이진 검색이 필요했음)
• Optifine (OptiFine이 많은 비호환성 문제를 일으키는 것으로 알려져 있다고 경고하고 현대적인 대안을 제안)
• OutOfMemoryError (Minecraft에 할당된 RAM이 부족함)
• ResourceLocationException (리소스 이름에 잘못된 문자가 포함됨, 종종 비영어권 시스템 설정으로 인해 발생)
• Rubidium (Rubidium이 중단되었으며 문제를 일으킨다고 경고하고 Embeddium을 제안)
• ServerConfigCorrupted (서버 측 설정 파일이 잘못된 형식임)
• UnsupportedClassVersion (모드가 사용 중인 Java보다 최신 버전의 Java로 컴파일됨)
• UsedByAnotherProcess (파일이 다른 프로그램에 의해 잠겨 있음)
• Version121 (Minecraft 1.21이 구식이며 많은 문제를 일으킨다고 경고하고 1.21.1로 전환할 것을 제안)

winevent (Windows 이벤트 로그):

• WasClosedByWindows (게임이 멈추고 OS에 의해 종료됨, 종종 로딩 중 사용자 입력으로 인해 발생)

Codex 로그 분석기 통합:

• 업로드 후 지원되는 모든 로그는 mclo.gs의 Codex 로그 분석기에 의해 분석됩니다. 때때로 Codex 메시지는 일반 사용자에게 명확하지 않을 수 있습니다. 이러한 경우 해결 방법 안내가 포함된 자세한 메시지가 표시됩니다:

• 오류가 발생한 블록/엔티티

이것은 문제의 큰 비율(75% 이상)이 흔하고 쉽게 해결할 수 있는 문제이기 때문에 모드팩 지원의 부담을 크게 줄여줍니다. 원한다면 설정에서 모든 분석을 블랙리스트에 추가할 수 있습니다.

분석 도구

Crash Assistant에는 GUI 메뉴에서 접근할 수 있는 강력한 분석 도구 모음이 포함되어 있습니다:

• Create/Epic Fight 애드온 호환성: 모드를 스캔하여 설치된 Create 또는 Epic Fight 버전과 호환되지 않는 애드온을 찾습니다.
• MCreator 모드 감지기: MCreator 도구로 만든 모든 모드를 나열합니다.
• 패키지/클래스 찾기: 모든 모드를 검색하여 특정 Java 클래스 또는 패키지를 포함하는 모드를 찾습니다.
• Jdeps 종속성 분석: 특정 클래스 또는 패키지에 의존하는 모드를 식별하여 NoClassDefFoundError 충돌을 디버깅하는 데 도움을 줍니다.

통합 GPU 감지:

더 강력한 전용 GPU가 사용 가능한데 게임이 통합 GPU에서 실행 중인지 확인하고 경고를 표시합니다. Windows가 Java에 올바른 GPU를 사용하도록 구성하는 원클릭 자동 수정 버튼을 포함합니다.

Intel 칩 버그 경고:

CPU가 치명적인 안정성 버그가 있는 것으로 알려진 Intel 13세대/14세대 모델에 해당하는지 감지합니다. 마이크로코드 버전을 확인하고 자세한 경고와 권장 사항을 제공합니다.

호환성:

이 모드는 최대한의 호환성과 안정성을 위해 설계되었습니다. Minecraft JVM이 중지될 때까지 기다리는 독립적인 프로세스에서 실행됩니다. Coremod(Forge) 또는 LanguageAdapter(Fabric/Quilt)로 매우 일찍 로드되어 초기 시작 충돌까지 잡아낼 수 있습니다.

원클릭으로 모든 로그 업로드 및 링크 복사:

원클릭으로 사용 가능한 모든 로그를 업로드하고 GitHub 또는 Discord에 붙여넣을 수 있는 깔끔하게 포맷된 메시지를 받을 수 있습니다. 모드팩 제작자라면 추가 파일을 요청할 필요 없이 모든 로그가 최신이며 사용 가능한 모든 정보를 포함하고 있다는 것을 항상 알 수 있습니다.

미리 구성된 링크에 참여하는 버튼:

모드팩 플레이어는 충돌 직후 원클릭으로 쉽게 Discord를 찾아 도움을 요청할 수 있습니다. 이는 뛰어난 로그 업로드 용이성과 결합되어 개별 충돌을 보고할 확률을 크게 높입니다. 개별 다운로드이거나 구성되지 않은 경우 사용자를 적절한 모드로더의 Discord 서버로 안내합니다.

모드 목록:

모드팩 제작자가 게임을 시작할 때마다 모드팩의 모드 목록을 저장합니다. /crashassistant modlist save 명령어를 사용하여 수동으로 모드 목록을 저장할 수도 있습니다. 모드팩과 개별 다운로드에서 다르게 작동합니다:

모드팩:

생성된 메시지에는 최종 사용자가 공식 모드팩 목록과 비교하여 추가, 제거 또는 업데이트한 모드 목록이 포함됩니다.

개별 다운로드 / 모드팩 제작자:

마지막 성공적인 실행 이후의 모드 목록 변경 사항을 추적하며, "모두 업데이트" 버튼을 누르거나 문제가 있는 모드를 추가하고 어떤 모드인지 잊어버린 경우 매우 유용할 수 있습니다.

설정:

완전히 구성 가능합니다: 모든 기능을 활성화 또는 비활성화하고, Discord 링크를 변경하고, 라벨, 버튼 등의 텍스트를 사용자 지정할 수 있습니다.

현지화:

완전히 현지화되었습니다. 현재 지원되는 언어:

• 영어
• 독일어
• 러시아어
• 중국어
• 스페인어
• 이탈리아어

하드코딩된 문자열은 없습니다(로깅 제외). 모든 표시되는 문자열을 변경할 수 있습니다. 더 많은 현지화 정보를 원하거나 새 언어를 추가하려면 lang README를 읽어보세요.

충돌 명령어:

/crashassistant crash에는 3가지 옵션이 있습니다:

• game - 충돌 보고서와 함께 Minecraft를 충돌시킵니다.
• jvm - hserrpid 파일과 함께 JVM을 충돌시킵니다.
• nocrash - 충돌 없이 추가 인수를 적용합니다.

충돌 대상 뒤에 추가 인수를 사용할 수 있습니다:

• --withThreadDump - 로그에 스레드 덤프를 생성합니다.
• --withHeapDump - 힙 덤프 파일을 생성합니다.
• --GCBeforeHeapDump - 힙 덤프 전에 가비지 컬렉션을 수행합니다.

문제가 있는 모드 설정:

problematicmodsconfig.json 설정 파일을 추가하여 모드를 모드팩과 호환되지 않는 것으로 표시할 수 있습니다. 두 가지 모드가 있습니다: 호환되지 않는 모드가 감지되면 게임을 충돌시키거나 단순히 사용자에게 알릴 수 있습니다. 모드를 추가한 최종 사용자에게는 왜 호환되지 않는지 설명하는 미리 구성된 메시지가 표시되고 제거할 수 있는 버튼이 제공됩니다.

파트너

YourKit은 Java 및 .NET 애플리케이션을 모니터링하고 프로파일링하기 위한 혁신적이고 지능적인 도구로 오픈 소스 프로젝트를 지원합니다. YourKit은 YourKit Java Profiler, YourKit .NET Profiler, YourKit YouMonitor의 제작자입니다.

개인정보 보호

로그는 사용자가 명시적으로 “Upload” 버튼을 클릭할 때만 업로드되며, Aternos가 운영하는 로그 공유 서비스인 mclo.gs로 직접 전송됩니다.

게시 전에 mclo.gs는 액세스 토큰, IP 주소, 시스템 사용자 이름 등과 같은 민감한 데이터를 자동으로 삭제하여 붙여넣기를 안전하게 공유할 수 있도록 합니다.

보존 기간, 로그에 액세스할 수 있는 사람, GDPR 권리에 대한 완전한 정보는 해당 개인정보 처리방침에서 확인할 수 있습니다.

mclo.gs의 모바일 UI가 불편할 수 있기 때문에 Crash Assistant는 기본적으로 반환된 URL을 gnomebot.dev를 통해 래핑합니다(예: https://mclo.gs/X → https://gnomebot.dev/paste/mclogs/X). 설정에서 이 동작을 비활성화할 수 있습니다. gnomebot.dev는 Latvian Modder가 만든 오픈 소스 온라인 로그 뷰어로, mclo.gs에서 데이터를 가져와 편리한 형식으로 사용자에게 표시하고, 마지막 액세스 후 5분 동안 붙여넣기를 RAM에 캐시한 다음 삭제합니다.

Crash Assistant 자체는 완전히 클라이언트 측입니다. 서버가 없으며 로그 사본을 받지 않습니다.

이것은 간략한 개인정보 보호 설명입니다. 전체 개인정보 처리방침은 Crash Assistant 내의 Privacy 메뉴에서 확인할 수 있습니다. Crash Assistant는 첫 로그 업로드 시도 시 개인정보 처리방침을 읽고 동의하도록 요청합니다.