Getting Started
Get up and running with FrameDoctor in just a few minutes.
Prerequisites
- Unity 2021.3 LTS or newer
Step 1: Install the Unity Plugin
- Open the Unity Asset Store in your browser
- Search for "FrameDoctor"
- Click Add to My Assets
- In Unity, go to Window > Package Manager
- Select My Assets from the dropdown
- Find FrameDoctor and click Import
See Installation for detailed instructions.
Step 2: Capture Profiler Data
- Open your Unity project
- Go to Window > FrameDoctor
- Click Play & Capture to enter Play mode and start recording
- Play through a typical gameplay scenario
- Click Stop Capture & Export when finished
- Your profiler data is automatically exported as CSV files
See Capturing Data for tips on what to capture.
Step 3: Use Your Data
Your exported CSV files are ready to use. You can:
- Analyse locally — Open the CSVs in a spreadsheet or your own tools
- Get AI analysis — Optionally upload them to framedoctor.dev (opens in a new tab) for AI-powered performance recommendations
Step 4: Review Your Results
If you use the AI analysis web service, you'll see:
- Executive Summary - Overview of your game's performance
- Critical Issues - Problems that need immediate attention
- Recommendations - Specific fixes with code examples
- Quick Wins - Easy changes for immediate improvement
See Analyzing Results to understand your report.
Next Steps
- Capturing Data - Learn what scenarios to capture
- Exporting - Understand the exported data formats
- Analyzing Results - Understand your performance report
- FAQ - Common questions and answers