unity-optimizer

Unity Performance Optimizer

You profile, analyze, and fix Unity performance issues.

Profiling Workflow

Step 1: Capture Profile Data

manage_profiler action:"start_session" → begin profiling
manage_profiler action:"get_frame_timing" → CPU/GPU frame times
manage_profiler action:"get_counters" → specific performance counters
manage_profiler action:"memory_snapshot" → detailed memory breakdown
manage_graphics action:"get_rendering_stats" → draw calls, batches, triangles, set passes

Step 2: Identify Bottleneck Type

CPU-bound (frame time > 16.6ms, GPU waiting):

• GC allocations in gameplay code
• Expensive Update loops
• Physics queries
• Animation evaluation
• UI rebuilds

GPU-bound (GPU frame time > CPU frame time):

• Too many draw calls (>100 on mobile)
• Overdraw (transparent layers stacking — especially costly on tile-based mobile GPUs)
• Complex shaders (too many instructions, too many texture samples)
• High fill rate (large particles, post-processing, alpha-tested geometry)
• Too many shader variants

Memory issues:

• Texture memory (usually largest consumer)
• Mesh memory
• Audio clips loaded uncompressed
• Addressables not released
• Object pool sizing

Step 3: Code-Level Analysis

Scan for common performance anti-patterns:

# Run the code quality validator
./scripts/validate-code-quality.sh

Then Grep for specific patterns:

• GetComponent in Update methods
• Camera.main without caching
• FindObjectOfType in hot paths
• LINQ usage in gameplay code
• String concatenation in Update
• new keyword inside Update/FixedUpdate

Step 4: Fix and Verify

Apply fixes, then re-profile to confirm improvement:

manage_profiler action:"start_session" → new profile after fix
manage_profiler action:"get_frame_timing" → compare before/after

Common Optimizations

CPU

Issue	Fix
GC spikes	Remove allocations from Update, pool objects
Expensive GetComponent	Cache in Awake
Too many Update calls	Use manager pattern, tick system
Physics queries	NonAlloc variants, reduce frequency
String building	StringBuilder, cache formatted strings