Crash Guard: 客户端恢复

🛡️ 崩溃护盾：客户端恢复

崩溃护盾：客户端恢复 是一款 Minecraft 1.20.1 Forge 客户端侧恢复模组，可帮助从特定崩溃中恢复，而不是立即关闭游戏。

当发生支持的客户端崩溃时，崩溃护盾会尝试捕获异常，生成崩溃报告，必要时安全断开与当前世界或服务器的连接，并通过详细的恢复界面将您带回主菜单。

目标并非阻止所有崩溃，而是使支持的客户端侧崩溃更容易诊断和恢复。

---

✨ 特性

🛡️ 客户端崩溃恢复

崩溃护盾可以从多种类型的客户端侧崩溃中恢复，包括：

• GUI 崩溃
• 屏幕渲染崩溃
• 工具提示崩溃
• 常规渲染崩溃
• 实体渲染崩溃
• 客户端刻崩溃
• 刻实体崩溃

---

📄 自动崩溃报告

每当崩溃被恢复时，崩溃护盾会自动：

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

---

🔍 疑似模组检测

崩溃护盾会分析堆栈跟踪，并尝试识别最有可能导致崩溃的模组。

这可以显著减少使用大型整合包时的故障排除时间。

---

📋 恢复界面

成功恢复后，崩溃护盾会显示一个专属恢复界面，包含：

• 崩溃类型
• 异常类
• 异常信息
• 疑似模组
• 崩溃报告位置
• Minecraft 版本
• 加载器信息
• 适用时的额外警告

可用操作：

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

---

⚠️ 刻实体警告

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

崩溃护盾会为此类情况提供额外警告，并包含防止意外实体移除的保障措施。

不会自动移除任何内容。

---

🔒 恢复安全系统

为防止无限恢复循环，崩溃护盾会监视一次会话中恢复操作的频率。

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

---

⚙️ 指令

查看可用指令

/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

---

❌ 崩溃护盾无法恢复的内容

崩溃护盾并非通用崩溃修复工具。

它无法从以下情况中恢复：

• 启动崩溃
• 模组加载崩溃
• 注册表崩溃
• 数据包崩溃
• JVM 崩溃
• 原生崩溃
• OpenGL 驱动程序崩溃
• 内存不足崩溃
• 其他超出支持恢复点的崩溃

---

🔧 工作原理

崩溃护盾使用 Mixin 来拦截特定的 Minecraft 客户端方法，例如渲染、GUI 处理、工具提示渲染、实体渲染和客户端刻。

当发生支持的运行时异常时，崩溃护盾会在 Minecraft 的正常致命崩溃处理器之前拦截崩溃，生成崩溃报告，安全退出当前会话，并打开恢复界面。

---

🎯 适用对象

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

---

🛡️ 总结

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

本模组使用 IntelliJ 创建

关于产品的免责声明：非官方 Minecraft 产品。未经 Mojang 或 Microsoft 批准，亦与之无关。