Godot Shader Compilation Stutter and Lag on First Run

How to fix it

Try these in order — the most common fix is first.

1. 1. Update to Godot 4.4 or newer

   Copy steps
   1. Upgrade the editor and export templates to 4.4 or later
   2. Re-export so pipelines are detected and precompiled at load time
   Did this fix it? Yes No

2. 2. Show features early

   Copy steps
   1. Put a scene that uses lights, particles and special features in the loading phase
   2. Avoid changing MSAA or adding VoxelGI during gameplay
   Did this fix it? Yes No

3. 3. Find sources with the debugger

   Copy steps
   1. Run the project and open Debugger > Monitors
   2. Check the pipeline compilation monitors to see what compiles during play
   3. Test with a cleared driver shader cache or on a weaker machine, since your own machine hides first-run stutter
   Did this fix it? Yes No

4. 4. Pre-draw 2D content

   1. Briefly draw each 2D effect off-screen during loading so it compiles before gameplay
   Did this fix it? Yes No

Symptoms

Brief freezes the first time an effect, light, particle or sprite appears, mostly on a player's first run or after a driver update.

Why it happens

• Pipelines are compiled the first time an object is drawn (pre-4.4 behaviour)
• 2D elements are not precompiled
• The Compatibility renderer does not support ubershaders or precompilation
• Changing MSAA or adding a VoxelGI node mid-game forces recompilation

This guide also covers

• godot shader stutter
• godot shader compilation lag
• godot 4 stutter first time
• godot ubershader
• godot pipeline precompilation

The same problem in other apps

All slow, laggy or resource-hungry guides →

• Why Is Unity Editor So Slow (Unity)
• Unreal Editor High CPU Usage When Idle (Unreal Engine)

Other Godot errors

• Godot No Export Template Found at the Expected Path
• Godot Android Export Failed (JDK, SDK and Keystore Errors)
• Godot 4 Crashes on Startup: Vulkan Device Errors
• Godot C# Error: Godot.NET.Sdk or .NET SDK Not Found
• Godot 3 to 4 Upgrade: Project Errors After Converting
• Godot Web Export Not Working: SharedArrayBuffer and Blank Page
• Godot Invalid Access to Property on Null Instance Error
• Godot Exported Game Blocked on macOS: Developer Cannot Be Verified