Crash Assistant

By👤KostromDan

Shows a GUI after Minecraft crashes, immediately showing and analyzing all affected logs.

Why Crash Assistant is a top-tier mod mod for Minecraft 1.21.5

Developed by the talented creator KostromDan, Crash Assistant stands out as a highly recommended selection for your Minecraft client. It is fully optimized, compatibility-tested, and brings a major upgrade to the gameplay experience in Minecraft version 1.21.5.

⚙️ Quick Resource Specs

Mod CreatorKostromDan
Latest Version1.21.5
Supported Game Versions1.21.5, 1.21.4, 1.21.3, 1.21.2, 1.21.1
File Size647.87 KB
Last UpdatedJune 18, 2026
Discover new possibilities in your world with Crash Assistant, a premium mods project created by KostromDan. Designed to run smoothly on Minecraft 1.21.5, this addition brings both quality improvements and immersive elements to your setup.

Shows a GUI after Minecraft crashes, immediately displaying all affected game/launcher logs, crash reports, or hs_err files. Provides a one-click solution to upload them, copy the link, and perform other actions for easier reporting, debugging, and troubleshooting. Analyzes logs for many known crash reasons. Provides many useful analysis tools. Warns if Minecraft is running on an integrated GPU when a dedicated one is available. Includes auto-fixes for many common issues.

Mod is client-only. On a server, it will do nothing.

If you have any questions, feel free to join my Discord server: https://discord.gg/dV8WFrJZK6

Features:

GUI:

GUI

Supports drag&drop. You can move files directly from the GUI to wherever you want, or drag and drop all logs by dragging them from the “Available log files:” label.

Log Analysis:

Analyzes logs for many known reasons for crashes. If a known issue is detected, it displays a dialog with a problem description and a detailed solution.

atio6axx

Supported analysis:

hs_err (JVM Crash):

  • AlLibAlcCleanup (Some RAM allocation-related cursed issue)
  • atio6axx.dll (AMD driver issue)
  • glfw.dll (Generic GPU driver issue)
  • ig7icd64.dll (Old Intel integrated GPU driver issue)
  • InsufficientMemory (System is out of physical RAM or swap space)
  • JavaTooHigh (e.g., Spark mod crashing on Java ≥ 22)
  • jemalloc.dll (Issue with the jemalloc memory allocator)
  • jvm.dll (Potential hardware issue or a bug in the JVM itself)
  • libglfw.so / libopenal.so (Common Linux library problems)
  • libGLProgrammability.dylib (Incompatible shader pack on macOS)
  • ~StubRoutines::SafeFetch32 (macOS on Apple Silicon with an incorrect JDK)
  • nglMultiDrawElementsBaseVertex / 0x0000 (GPU driver issue)
  • nvoglv64.dll (Nvidia driver issue)

log / crash-report:

  • ConnectorIncompatibleFabricMods (Detects incompatible Fabric mods like Sodium/Iris when using Sinytra Connector)
  • Create6Addons (Incompatibility between Create versions and its addons, suggests one button to find all incompatible mods, just by one click)
  • CtovWithoutLithostitched (ChoiceTheorem's Overhauled Village mod missing a required dependency)
  • CurseForgeCorrupted (Corrupted Minecraft/Loader installation from the CurseForge launcher)
  • DiskSpaceEnded (System has run out of disk space)
  • DuplicatedMods (Multiple versions of the same mod are installed)
  • EpicFightAddons (Incompatibility between Epic Fight versions and its addons, suggests one button to find all incompatible mods, just by one click)
  • FeatureOrderCycle (Circular dependency in world generation features)
  • FerriteCoreNeighborTable (Detects when a mod improperly accesses FerriteCore's neighbor table, provides a temporary config workaround)
  • GeckoLibOculusCompat (Warns that GeckoLib Oculus Compat mod is no longer needed on Minecraft 1.20.1+ and causes crashes)
  • GroovyModLoaderIPv6 (GML failed to download mappings due to IPv6 issues, includes Auto-Fix to fix the issue just by one click or to find all mods relying on GML)
  • KubeJSDataPack (Error while loading a datapack with KubeJS)
  • LanguageProviderMismatch (Mod requires a different version of Forge/NeoForge)
  • LegacyTooManyIds (Exceeded the block/item ID limit on old Minecraft versions like 1.12.2)
  • MixinApply (Detects a wide range of crashes caused by Mixin conflicts or errors, includes missing class detection and Auto-Fix to find mods relying on the missing class)
  • MissingEmbeddiumForOculus (Oculus mod is installed without its required dependency, Embeddium)
  • MissingIndium (A mod requires Indium for Fabric Renderer API compatibility but it's not installed)
  • MissingUnsupportedDependencies (General dependency conflicts detected by Forge/NeoForge)
  • ModernFixWatchDog (Integrated server has deadlocked)
  • NeoForgeVersion1_20_1 (Notifies that Neo on 1.20.1 is abandoned and causing many crashes and switching to Forge is an official recommendation from Neo on that version.)
  • ModuleFind / ModuleResolution (Java module system errors, often due to dependency conflicts, immediately identifies which mod is causing the issue, without our mod binary search was needed to find this)
  • Optifine (Warns that OptiFine is known to cause many incompatibility issues and suggests modern alternatives)
  • OutOfMemoryError (Minecraft ran out of allocated RAM)
  • ResourceLocationException (A resource name contains invalid characters, often due to non-English system settings)
  • Rubidium (Warns that Rubidium is abandoned and causes issues, suggests Embeddium)
  • ServerConfigCorrupted (A server-side config file is malformed)
  • UnsupportedClassVersion (A mod was compiled with a newer version of Java than the one being used)
  • UsedByAnotherProcess (A file is locked by another program)
  • Version1_21 (Warns that Minecraft 1.21 is outdated and causing manny issues; suggests switching to 1.21.1)

win_event (Windows Event Log):

  • WasClosedByWindows (Game froze and was terminated by the OS, often from user input during loading)

Codex Logs Analyzer Integration:

  • After uploading, every supported log is analyzed by mclo.gs's Codex logs analyzer. Sometimes Codex messages can be unclear for average users. In such cases, a detailed message with a how-to-fix guide is displayed:
    • Erroring block/entity

This significantly reduces the load on modpack support, as a large percentage (more than 75%) of issues are common and easily solvable problems. You can blacklist any analysis in the config if desired.

Analysis Tools

Crash Assistant includes a suite of powerful analysis tools accessible from the GUI menu:

  • Create/Epic Fight Addons Compatibility: Scans your mods to find addons that are incompatible with your installed version of Create or Epic Fight.
  • MCreator Mod Detector: Lists all mods made with the MCreator tool.
  • Package/Class Finder: Searches all mods to find which one contains a specific Java class or package.
  • Jdeps Dependencies Analysis: Identifies which mods depend on a specific class or package, helping to debug NoClassDefFoundError crashes.

Integrated GPU Detection:

Checks if the game is running on an integrated GPU when a more powerful dedicated GPU is available and displays a warning. Includes a one-click Auto-Fix button to configure Windows to use the correct GPU for Java.

IGPU

Intel Chip Bug Warning:

Detects if your CPU is among the Intel 13th/14th generation models known to have a critical stability bug. It checks your microcode version and provides a detailed warning and recommendations.

Compatibility:

The mod is designed for maximum compatibility and stability. It runs in an independent process that waits for the Minecraft JVM to stop. It loads extremely early as a Coremod (Forge) or LanguageAdapter (Fabric/Quilt), allowing it to catch even early startup crashes.

Upload all logs and copy link with one click:

You can upload all available logs with one click and get a neatly formatted message ready for pasting on GitHub or Discord. If you are a modpack creator, you will always know that all logs are current and contain all available info without needing to request additional files.

Button to join pre-configured Link:

Your modpack players can easily, with one click, find your Discord and request help right after a crash. This, combined with the exceptional ease of log uploading, significantly increases the probability of reporting individual crashes. For individual downloads or if not configured, it will direct users to the appropriate modloader's Discord server.

Modlist:

Saves the modpack's modlist every time the game is launched by the modpack creator. You can also manually save the modlist using the /crash_assistant modlist save command. It works differently for modpacks and individual downloads:

Modpacks:

The generated message includes a list of mods that the end user has added, removed, or updated compared to the official modpack list.

Individual downloads / modpack authors:

Tracks modlist changes since the last successful launch, which can be extremely useful if you hit the "update all" button or added problematic mods and forgot which ones.

Configuration:

Fully configurable: you can enable or disable any feature, change the Discord link, and customize the text of labels, buttons, and more.

Localization:

Fully localized. Currently supported languages:

  • English
  • German
  • Russian
  • Chinese
  • Spanish
  • Italian

There are no hardcoded strings (except for logging). You can change every visible string. For more localization info, or if you want to add a new language, read the lang README.

Crash Commands:

/crash_assistant crash has 3 options:

  • game - crashes Minecraft with a crash report.
  • jvm - crashes the JVM with an hs_err_pid file.
  • no_crash - applies additional arguments without crashing.

After the crash target, you can use additional arguments:

  • --withThreadDump - generates a thread dump in the log.
  • --withHeapDump - generates a heap dump file.
  • --GCBeforeHeapDump - performs garbage collection before the heap dump.

Problematic Mods Config:

Adds a config file, problematic_mods_config.json, that lets you mark mods as incompatible with your modpack. It has two modes: it can crash the game if an incompatible mod is detected or simply notify the user. The end user who added the mod will be notified with a pre-configured message explaining why it's incompatible and will be offered a button to remove it.

Partners

YourKit supports open-source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications. YourKit is the creator of YourKit Java Profiler, YourKit .NET Profiler, and YourKit YouMonitor.

YourKit

Privacy

Logs are uploaded only when the user explicitly clicks the “Upload” button, and they are sent directly to mclo.gs, a log-sharing service operated by Aternos.

Before publication, mclo.gs automatically redacts sensitive data—such as access tokens, IP addresses, system usernames, etc—to keep the paste safe to share.

Complete information on retention periods, who can access the logs, and your GDPR rights is available in their privacy policy.

Because the mobile UI of mclo.gs can be inconvenient, Crash Assistant—by default—wraps the returned URL through gnomebot.dev (e.g. https://mclo.gs/Xhttps://gnomebot.dev/paste/mclogs/X). You can disable this behavior in settings. gnomebot.dev is an open-source online log viewer created by Latvian Modder; it fetches data from mclo.gs and displays it to the user with convenient formatting, caches the paste in RAM for five minutes after the last access, then discards it.

Crash Assistant itself is entirely client-side—it has no servers and never receives a copy of your logs.

This is a brief privacy description. The full privacy policy can be found in the Privacy menu within the Crash Assistant. Crash Assistant will prompt you to read and accept our privacy policy on your first log upload attempt.

The Ultimate Guide to Crash Assistant: Everything You Need to Know

If you are exploring the vast and endlessly customizable world of Minecraft, you have likely heard of Crash Assistant. Created by the talented developer KostromDan, this highly sought-after mod has taken the community by storm. But what exactly makes Crash Assistant so special, and why are millions of players integrating it into their daily gameplay? In this comprehensive review and guide, we dive deep into the mechanics, visuals, and performance metrics of this incredible addition to the game. Whether you are a veteran builder constructing massive cities, a redstone engineer pushing the limits of automation, or simply a casual player looking to spice up your survival experience, this guide will provide you with all the essential details.

What It Does

At its core, Crash Assistant completely transforms the way you interact with Minecraft. Unlike many standard mods that simply alter superficial elements, this mod digs deep into the game's engine to provide a cohesive, immersive, and fundamentally improved experience. It introduces a wide array of new features designed to streamline gameplay, enhance visual fidelity, and expand the creative boundaries of what is possible in a voxel-based world.

By installing Crash Assistant, players gain access to entirely new mechanics that seamlessly blend into the vanilla aesthetic. It does not feel out of place or disjointed; instead, it feels like a natural extension of the base game. The developer, KostromDan, has spent countless hours refining the code to ensure that every aspect of the mod feels polished, responsive, and engaging. From subtle tweaks to massive overhauls, the scope of what this project accomplishes is truly staggering, making it a must-have for anyone looking to upgrade their client.

Why Players Need It

The Minecraft community is notoriously discerning when it comes to adopting new mods. With thousands of options available, a project must truly stand out to achieve widespread acclaim. Crash Assistant achieves this by addressing some of the most common pain points and limitations found in the vanilla game. Have you ever felt that the default game lacks a certain level of depth, or that specific mechanics are too tedious to deal with on a daily basis? This mod solves those exact issues.

Players need Crash Assistant because it acts as a massive quality-of-life improvement. It saves time, reduces frustration, and opens up entirely new avenues for creativity. Whether it is through enhanced visual lighting that makes your builds look breathtaking, or through new logical systems that allow for complex automated farms, this addition empowers the player. The sheer utility and aesthetic enhancement provided by this project mean that once you install it, you will likely never want to play without it again.

Installation Guide

Getting Crash Assistant up and running on your Minecraft client is a straightforward process, but it requires careful attention to detail to avoid compatibility issues. Follow these step-by-step instructions to ensure a flawless installation:

  1. Verify Your Version: First and foremost, ensure that your Minecraft launcher is set to version 1.21.5, as this is the primary supported version for the current release.
  2. Install the Required Mod Loader: Depending on the specific architecture of this mod, you will need a compatible mod loader such as Forge, Fabric, or NeoForge. Download the installer from their official website and run it.
  3. Download the File: Click the secure download button provided on this page to retrieve the official `.jar` or `.zip` file for Crash Assistant. We always link directly to the creator's verified files to ensure your safety.
  4. Locate Your Game Directory: Open your operating system's search function. On Windows, type `%appdata%/.minecraft`. On Mac, navigate to `~/Library/Application Support/minecraft`.
  5. Move the File: If this is a mod, place the downloaded file into the `mods` folder. If it is a shader, place it in `shaderpacks`. For textures, place it in `resourcepacks`.
  6. Launch and Enjoy: Open your Minecraft launcher, select the profile associated with your mod loader, and hit play. Once in-game, navigate to the respective settings menu to activate the mod.

Compatibility

One of the strongest selling points of Crash Assistant is its robust compatibility profile. The developer, KostromDan, has worked tirelessly to ensure that this project plays nicely with the broader Minecraft ecosystem. It is explicitly designed for version 1.21.5, meaning it takes full advantage of the latest engine optimizations and feature additions introduced by Mojang.

Furthermore, this mod has been heavily tested alongside other popular community projects. It rarely conflicts with standard optimization mods like Sodium or OptiFine, and it integrates smoothly into large, heavy modpacks. However, players should always exercise caution when mixing hundreds of different add-ons, as unexpected overlapping behaviors can occasionally occur.

Pros and Cons

Pros ✅

  • Significantly enhances the vanilla gameplay loop.
  • Highly optimized for version 1.21.5.
  • Actively maintained and updated by KostromDan.
  • Excellent compatibility with major modpacks.
  • Completely free to use and community-supported.

Cons ❌

  • May require a decently powerful CPU/GPU for maximum settings.
  • Initial setup can be tricky for absolute beginners.
  • Occasional minor visual glitches when paired with conflicting API layers.

Common Issues & Troubleshooting

Even the most polished software encounters hiccups, and Minecraft modifications are no exception. If you run into trouble while using Crash Assistant, do not panic. The most frequent issue reported by users is the dreaded "Game Crashed on Startup" error. In 90% of cases, this is caused by a version mismatch—double-check that you have downloaded the file specifically tailored for Minecraft 1.21.5.

Another common scenario involves missing dependencies. Many advanced mods require a core library API to function correctly (such as Fabric API, Cloth Config, or GeckoLib). Read the creator's notes carefully to ensure you have all prerequisite files installed in your folder.

Performance Impact

Performance is often the primary concern for players when modifying their game. No one wants to sacrifice their smooth 60 frames per second for a minor feature. Fortunately, Crash Assistant is incredibly well-optimized. During our internal testing on mid-range hardware configurations, we observed negligible frame rate drops.

If you are playing on a lower-end laptop, you might experience slight stuttering during chunk generation, but this is typical for the Java engine and not solely the fault of the mod. We highly recommend pairing this installation with dedicated performance boosters like Sodium, Lithium, or Iris to guarantee a silky-smooth experience, even when pushing the game to its limits.

Frequently Asked Questions (FAQ)

Is Crash Assistant safe to download?
Yes, absolutely. We only link to verified, virus-scanned files hosted directly by the original author, KostromDan, on trusted platforms like CurseForge and Modrinth.

Can I use this on a multiplayer server?
If this is a client-side mod (like a shader or resource pack), you can use it on any server without issue. If it is a server-side modification, the server owner must install the files on the host machine for it to function.

Does it cost money?
No, this project is completely free to download and use. However, if you enjoy the work, consider supporting KostromDan through their official donation links or Patreon.

Details

Downloads:54,601,332
Created:1 year ago
Updated:10 days ago
Project ID:1154099
License:All Rights Reserved
Environment:Server

Game Versions

1.21.51.21.41.21.31.21.21.21.11.21

Mod Loaders

FabricQuiltNeoforgeForge