🛡️ 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.

🛡️ 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