About Crash Guard: Client Recovery
From ModrinthRecover from supported client-side crashes and safely return to the main menu instead of immediately closing Minecraft.
🛡️ Crash Guard: Client Recovery
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.
✨ Features
🛡️ Client Crash Recovery
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
📄 Automatic Crash Reports
Whenever a crash is recovered, Crash Guard automatically:
- Creates a dedicated crash report
- Records exception information
- Stores recovery details
- Saves useful debugging information
🔍 Suspected Mod Detection
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.
📋 Recovery Screen
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 Warnings
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.
🔒 Recovery Safety System
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.
⚙️ Commands
View Available Commands
/crashguard help
Check Current Status
/crashguard status
Displays:
- Recovery status
- Debug mode status
- Recovery count
- Safe mode status
🧪 Testing Recovery
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
❌ What Crash Guard Does NOT Recover
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
🔧 How It Works
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.
🎯 Perfect For
- Players using large modpacks
- Modpack developers
- Mod developers
- Testers
- Server communities
- Anyone who wants better crash diagnostics and recovery tools
🛡️ Summary
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.
This mod have been created with IntelliJ
Disclaimer about product: NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT
Highlights
From source dataGame versions
Supports 8 Minecraft versions, the newest being 26.2.
Loaders
Runs on Fabric, Forge and NeoForge.
Footprint
Rated a light load on a server.
Crash Guard: Client Recovery on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers. We download it from Modrinth, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Fabric, Forge, NeoForge
- Server load
- light
- Smallest plan we suggest
- Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.0.0-fabric-26.2, released 2026-06-24
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| NeoForge | 26.1 to 26.2 (4 versions) | 26.2 |
| Fabric | 26.2 | 26.2 |
From 5 recorded builds of Crash Guard: Client Recovery.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 1.0.0-fabric-26.2 | 2026-06-24 | 26.2 | Fabric |
| 1.0.0-neoforge-26.2 | 2026-06-24 | 26.2 | NeoForge |
| 1.0.0-neoforge-26.1.2 | 2026-05-30 | 26.1.2 | NeoForge |
| 1.0.0-neoforge-26.1.1 | 2026-05-30 | 26.1.1 | NeoForge |
| 1.0.0-neoforge-26.1 | 2026-05-30 | 26.1 | NeoForge |
Run Crash Guard: Client Recovery on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogQuality of life & UI
Small conveniences, tweaks and interface improvements players notice straight away.
Runs on your server
From source side supportModrinth lists Crash Guard: Client Recovery as required on the server. Check its Modrinth page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- FabricForgeNeoForge
- Runs on
- Serverrequired on the server
- Game versions
- 26.2 and 7 earlier
Verified at the source
- ✓ModrinthOfficial listing, checked 2026-10-02Open ↗
- ✓AuthorSmartStreamLabs, as published on Modrinth
- ✓LicenseGPL-3.0-onlyFree
