Crash Guard: Client Recovery

🛡️ Crash Guard：客户端崩溃恢复

Crash Guard：客户端崩溃恢复这是一款适用于 Minecraft 1.20.1 Forge 客户端的崩溃恢复模组，可帮助你从某些崩溃中恢复，而不是立即关闭游戏。

发生受支持的客户端崩溃时，Crash Guard 会尝试捕获异常、生成崩溃报告，并在必要时安全断开与当前世界或服务器的连接，随后返回主菜单并显示详细的恢复界面。

本模组并非旨在阻止所有崩溃，而是让受支持的客户端崩溃更容易诊断和恢复。

✨ 功能

🛡️ 客户端崩溃恢复

Crash Guard 可以从多种客户端崩溃中恢复，包括：

• GUI 崩溃
• 屏幕渲染崩溃
• 提示框崩溃
• 常规渲染崩溃
• 实体渲染崩溃
• 客户端 tick 崩溃
• 实体 tick 崩溃

📄 自动生成崩溃报告

每当成功恢复崩溃时，Crash Guard 会自动：

• 创建专用的崩溃报告
• 记录异常信息
• 保存恢复详情
• 保存有用的调试信息

🔍 疑似问题模组检测

Crash Guard 会分析堆栈跟踪，并尝试找出最可能导致崩溃的模组。

使用大型整合包时，这项功能可以显著缩短故障排查时间。

📋 恢复界面

成功恢复后，Crash Guard 会显示专用的恢复界面，其中包含：

• 崩溃类型
• 异常类
• 异常消息
• 疑似问题模组
• 崩溃报告位置
• Minecraft 版本
• 加载器信息
• 适用时显示的其他警告

可用操作：

• 复制崩溃摘要
• 复制 Discord 报告
• 打开崩溃报告文件夹
• 返回主菜单

⚠️ 实体 tick 警告

如果问题实体仍存在于世界中，实体 tick 崩溃可能会再次发生。

针对这种情况，Crash Guard 会提供额外警告，并加入保护措施，避免意外移除实体。

不会自动移除任何内容。

🔒 恢复安全系统

为防止陷入无限恢复循环，Crash Guard 会监控每次游戏会话中的恢复频率。

如果短时间内发生过多次恢复，模组会自动进入安全模式，并停止尝试进一步恢复。

⚙️ 命令

查看可用命令

/crashguard help

检查当前状态

/crashguard status

显示：

• 恢复状态
• 调试模式状态
• 恢复次数
• 安全模式状态

🧪 测试恢复功能

仅在启用调试模式时才能使用测试命令。

文件：

config/crashguard-client.toml

启用：

debugMode = true

可用测试命令：

• /crashguard test gui
• /crashguard test tooltip
• /crashguard test render
• /crashguard test entityrender
• /crashguard test clienttick
• /crashguard test tickingentity
• /crashguard test suspectedmod
• /crashguard test repeat

适用于正常游戏和正式发布版本：

debugMode = false

❌ Crash Guard 无法恢复的情况

Crash Guard 并非通用的崩溃修复工具。

它无法恢复以下情况：

• 启动崩溃
• 模组加载崩溃
• 注册表崩溃
• 数据包崩溃
• JVM 崩溃
• 原生崩溃
• OpenGL 驱动崩溃
• 内存不足导致的崩溃
• 不属于受支持恢复环节的其他崩溃

🔧 工作原理

Crash Guard 使用 Mixins 拦截 Minecraft 客户端中的特定方法，例如渲染、GUI 处理、工具提示渲染、实体渲染和客户端刻。

发生受支持的运行时异常时，Crash Guard 会在 Minecraft 的常规致命崩溃处理程序运行之前拦截崩溃、生成崩溃报告、安全退出当前会话，并打开恢复界面。

🎯 非常适合

• 使用大型整合包的玩家
• 整合包开发者
• 模组开发者
• 测试人员
• 服务器社区
• 希望获得更完善的崩溃诊断和恢复工具的任何人

🛡️ 概述

从受支持的 Minecraft 客户端崩溃中恢复、保存崩溃报告、识别疑似模组，并安全返回主菜单，而不是立即关闭游戏。

此模组使用 IntelliJ 创建

产品免责声明：这不是一款官方的 Minecraft 产品，未经 Mojang 或 Microsoft 批准，也与其无关。