Crash Guard: Client Recovery

# 🛡️ 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. !(https://cdn.modrinth.com/data/cached_images/ae01bbac0410f9b25e1954caa98c5fdfb53497a2.gif) --- ## ✨ 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.** !(https://cdn.modrinth.com/data/cached_images/2f981cdb0f9bd8d718bf44ee4eb86d402e673891.png) This mod have been created with IntelliJ **Disclaimer about product: NOT AN OFFICIAL MINECRAFT PRODUCT. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT**