Differences

This shows you the differences between two versions of the page.

--- manual:troubleshooting [2026/01/13 09:56] – dcs
+++ manual:troubleshooting [2026/01/13 10:05] (current) – dcs
@@ Line 7: / Line 7: @@
 They may not resolve every issue, as some problems can have multiple or more complex causes.
 </WRAP>
+----
+===== Unreal Project takes very long to load on first start =====
+==== Problem ====
+When opening the Modding SDK Unreal project for the **first time**, the editor takes a very long time to load or appears to be stuck indefinitely.
+In some cases, it may look like:
+  * the editor has frozen
+  * the loading screen does not progress
+  * the project is not responding for an extended period of time
+----
+==== Possible Cause ====
+The Modding SDK is delivered **without precompiled shaders**.
+This means:
+  * Unreal Engine has to compile all required shaders on first launch
+  * Shader cache folders and intermediate files must be generated
+  * This process is **very GPU-intensive**
+On systems with:
+  * older graphics cards
+  * slower CPUs
+  * limited system resources
+shader compilation can take a significant amount of time.
+----
+==== Possible Solution ====
+  * **Wait until the shader compilation is completed**
+  * Do **not** close Unreal Engine during this process
+  * Monitor CPU and GPU usage to verify that the process is still active
+Once the shaders are compiled:
+  * the project will load normally
+  * subsequent editor launches will be **much faster**
+This behavior is expected and only occurs during the first startup or after major engine or SDK updates.
 ----
@@ Line 53: / Line 98: @@
 After reducing path and file name lengths so that they remain below **255 characters**, run **BuildMod.bat** again.
-----
+{{page>manual:footer}}