From ba57aee59d7ca6dab374272a6f57471e178e7dfa Mon Sep 17 00:00:00 2001
From: skyace65 <matthewehr@hotmail.com>
Date: Mon, 20 Jan 2025 20:26:45 -0500
Subject: [PATCH] Document recovery mode

---
 .../editor_ui_intro_project_manager_13.webp   | Bin 0 -> 1670 bytes
 tutorials/editor/project_manager.rst          |  26 ++++++++++++++++++
 tutorials/troubleshooting.rst                 |   9 ++++++
 3 files changed, 35 insertions(+)
 create mode 100644 tutorials/editor/img/editor_ui_intro_project_manager_13.webp

diff --git a/tutorials/editor/img/editor_ui_intro_project_manager_13.webp b/tutorials/editor/img/editor_ui_intro_project_manager_13.webp
new file mode 100644
index 0000000000000000000000000000000000000000..f41b5e28ac0ccb997ba24754f814ca094fa82ac7
GIT binary patch
literal 1670
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
QQU(R_X+-~)pSjX708l|o761SM

literal 0
HcmV?d00001

diff --git a/tutorials/editor/project_manager.rst b/tutorials/editor/project_manager.rst
index 126522f11..e7c3413f8 100644
--- a/tutorials/editor/project_manager.rst
+++ b/tutorials/editor/project_manager.rst
@@ -144,3 +144,29 @@ you created.
 To remove a tag from your project manager it must be removed from all the projects it's
 used by. Once that's done close the project manager, open it up again, and the tag should
 be gone.
+
+Recovery Mode
+-------------
+
+If a project is immediately crashing on startup, or crashing frequently during
+editing it can be opened in recovery mode, to attempt to make it more stable
+while looking for the source of the crashing to fix it.
+
+Usually a project should open in recovery mode automatically when you re-open it
+after a crash. If it doesn't you can manually open recovery mode by selecting the
+project in the project manager, to do that select the project from your list of
+projects, click the dropdown button next to the edit node, and select ``Edit in
+recovery mode``.
+
+.. image:: img/editor_ui_intro_project_manager_13.webp
+
+While in recovery mode the following are disabled:
+
+- Tool scripts
+- Editor plugins
+- GDExtension addons
+- Automatic scene restoring
+- Running the project
+
+It is recommended that you backup your project before editing it in recovery
+mode.
diff --git a/tutorials/troubleshooting.rst b/tutorials/troubleshooting.rst
index d3b1a819e..24326fb74 100644
--- a/tutorials/troubleshooting.rst
+++ b/tutorials/troubleshooting.rst
@@ -251,3 +251,12 @@ On Windows, this can also be due to :ref:`case sensitivity
 in your script with a different case than on the filesystem, loading will fail
 once you export the project. This is because the virtual PCK filesystem is
 case-sensitive, while Windows's filesystem is case-insensitive by default.
+
+The project crashes frequently or instantly after opening it from the project manager
+-------------------------------------------------------------------------------------
+
+This could be caused by a number of things such as an editor plugin, GDExtension
+addon, or something else. In this scenario it's recommended that you open the
+project in recovery mode, and attempt to find and fix whatever is causing the
+crashes. See the :ref:`Project Manager page <doc_project_manager>` for more
+information.