Project Optimizations Panel
Window > AGS > Project Optimizations
A standalone Editor window that audits and configures 12+ engine-level optimizations. It features a collapsible help system—click the [?] icon on the far right of any section to reveal detailed explanations.
| Optimization | What It Does |
|---|---|
| SRP Batcher | Groups draw calls to reduce CPU overhead |
| Static Batching | Combines static meshes at build time |
| Dynamic Batching | Combines small dynamic meshes at runtime |
| GPU Skinning | Offloads mesh deformation to the GPU |
| Graphics Jobs | Multithreaded rendering |
| Incremental GC | Spreads garbage collection across frames |
| Strip Unused Mesh Components | Removes unused mesh data from builds |
| Frame Timing Stats | Enables precise CPU/GPU frame timing |
| Texture Streaming | Loads only needed mip levels (with memory budget slider) |
| Async Shader Compilation | Avoids shader compile stuttering |
| Enter Play Mode (Skip Domain Reload) | Faster Play Mode entry |
| Shader Variant Stripping | Reduces build size by stripping unused variants |
| Occlusion Culling | Skips rendering of hidden objects |
| Shader Prewarming Cache | Generates a global cache to prevent "cyan flashes" |
Shader Prewarming Cache (Eliminating Cyan Flashes)
When switching quality tiers (e.g., from Low to Ultra), the engine often needs to compile new shader variants that weren't active before. This causes a brief "cyan/magenta flash" and a frame stutter.
AGS provides an automated tool to solve this:
- In the Project Optimizations panel, find the Shader Prewarming Cache section.
- Click "Generate Global Shader Cache".
- AGS will automatically open every scene in your Build Settings and extract all shaders and keywords in use.
- It creates a
AGS_ShaderCollection.shadervariantsfile inAssets/Resources. - This file is automatically injected into Unity's Graphics Settings > Preloaded Shaders and assigned to the AutoConfigManager.
- At runtime, AGS calls
WarmUp()on this collection to ensure all shaders are ready before the visual swap occurs.
Usage
[!WARNING] Before clicking Apply All Recommended, it is strongly advised to backup your project or use version control. These options make permanent changes to Unity's
PlayerSettingsandGraphicsSettingsfiles!
- Open the panel.
- Review each optimization - green ✅ means enabled, red ❌ means disabled.
- Click "Fix All Recommended" to apply all safe optimizations at once.
- Or click individual "Fix Now" / "Open Settings" buttons for manual control.
Texture Streaming Memory Budget
The panel includes an interactive slider for texture streaming memory (512 MB to 32 GB):
- Increments in multiples of 512 MB up to 8 GB.
- Increments in multiples of 1024 MB above 8 GB.
- Displays the value in GB for readability.
- Shows a warning for budgets below 2 GB.