Crash Guard: Client Recovery is a Minecraft 1.20.1 Forge client-side recovery mod that helps recover from certain crashes instead of immediately closing the game.
When a supported client crash occurs, Crash Guard attempts to catch the exception, generate a crash report, safely disconnect from the current world or server if necessary, and return you to the main menu with a detailed recovery screen.
The goal is not to prevent every crash, but to make supported client-side crashes easier to diagnose and recover from.
Crash Guard can recover from several types of client-side crashes, including:
GUI crashes
Screen rendering crashes
Tooltip crashes
General rendering crashes
Entity rendering crashes
Client tick crashes
Ticking entity crashes
Whenever a crash is recovered, Crash Guard automatically:
Creates a dedicated crash report
Records exception information
Stores recovery details
Saves useful debugging information
Crash Guard analyzes the stacktrace and attempts to identify the mod most likely responsible for the crash.
This can significantly reduce troubleshooting time when using large modpacks.
After a successful recovery, Crash Guard displays a dedicated recovery screen showing:
Crash type
Exception class
Exception message
Suspected mod
Crash report location
Minecraft version
Loader information
Additional warnings when applicable
Available actions:
Copy Crash Summary
Copy Discord Report
Open Crash Report Folder
Return to Main Menu
Ticking entity crashes may occur again if the problematic entity still exists in the world.
Crash Guard provides additional warnings for these situations and includes safeguards to prevent accidental entity removal.
Nothing is removed automatically.
To prevent endless recovery loops, Crash Guard monitors how often recoveries occur during a session.
If too many recoveries happen within a short period, the mod automatically enters safe mode and stops attempting further recoveries.
/crashguard help
/crashguard status
Displays:
Recovery status
Debug mode status
Recovery count
Safe mode status
Test commands are only available when debug mode is enabled.
File:
config/crashguard-client.toml
Enable:
debugMode = true
Available test commands:
/crashguard test gui
/crashguard test tooltip
/crashguard test render
/crashguard test entityrender
/crashguard test clienttick
/crashguard test tickingentity
/crashguard test suspectedmod
/crashguard test repeat
For normal gameplay and release builds:
debugMode = false
Crash Guard is not a universal crash fixer.
It does not recover from:
Startup crashes
Mod loading crashes
Registry crashes
Datapack crashes
JVM crashes
Native crashes
OpenGL driver crashes
Out of memory crashes
Other crashes outside supported recovery points
Crash Guard uses Mixins to intercept specific Minecraft client methods such as rendering, GUI handling, tooltip rendering, entity rendering, and client ticking.
When a supported runtime exception occurs, Crash Guard intercepts the crash before Minecraft's normal fatal crash handler, generates a crash report, safely exits the current session, and opens the recovery screen.
Recover from supported Minecraft client crashes, save crash reports, identify suspected mods, and safely return to the main menu instead of immediately closing the game.
