FuzzyOptimizer — Comprehensive Documentation
Automated Scene Auditing, Performance Profiling & 1-Click Optimization Toolkit for Unity
Version:1.0.0| Developer: Fuzzy Logic Labs | Platform: Unity 2022.3+
Render Pipelines: Universal Render Pipeline (URP 17+ recommended) & Built-in Render Pipeline
Support & Inquiries: devbayk@gmail.com | Discord Community
Welcome to FuzzyOptimizer
FuzzyOptimizer by Fuzzy Logic Labs is a comprehensive editor toolkit and runtime suite engineered to find and fix performance bottlenecks in Unity scenes. It audits open scenes against customizable platform performance budgets, executes non-destructive and revertible automated fixes, and provides powerful sub-systems for mesh combining, synchronized PBR texture atlasing, HLOD generation, Burst-compiled mesh decimation, LOD generation, collider optimization, multi-angle impostor baking, and runtime pooling.
flowchart LR
A["1. Scene Scan (F5)"] --> B["2. Scene Doctor (49 Rules)"]
B --> C["3. 1-Click Optimize"]
C --> D["4. Benchmark & Measure FPS"]
D --> E["5. Keep or Revert Session"]
Documentation Table of Contents
Navigate through the 12 comprehensive chapters covering every system, editor tool, and runtime component:
| Chapter | Topic | Description |
|---|---|---|
| 01. Getting Started | Installation & First Steps | System requirements, package layout, running your first scene audit, and first optimization workflow. |
| 02. Dashboard & Editor UI | Core Interface | Window menus, header controls, overview stats, Scene View Heatmap, Hierarchy issue badges, and asset cleanup. |
| 03. Scene Doctor | Diagnostic Engine | Health score calculation (0–100), severity levels, fix safety ratings (Safe vs. Moderate), false positive ignores, and session revert. |
| 04. Rule Reference | 49 Audit Rules Catalog | Complete catalog of all 49 rules across 17 categories with stable IDs, conditions, and automated repair actions. |
| 05. One-Click Optimize | Automated Pipelines | Safe, Balanced, and Aggressive presets, 14 sequential pipeline steps, and Play Mode FPS before/after benchmarking. |
| 06. Optimization Tools | Editor Tool Suite | Smart Mesh Combiner, Synchronized Lit Texture Atlas, HLOD, Burst QEM Decimator, Auto LOD, Collider Optimizer, and Impostor Baker. |
| 07. Runtime Components | Player-Ready Systems | ZeroAllocPoolManager, GlobalVFXBudgetLimiter, LayerDistanceCuller, camera billboards, impostors, and benchmark markers. |
| 08. Reports, CI & Build Check | Automation & Quality Gates | Exporting self-contained HTML/JSON reports, headless -executeMethod CLI for GitHub Actions, and Player Build Quality Gates. |
| 09. Profiles & Settings | Platform Profiles & Config | Platform budget presets (Mobile, VR, Desktop), custom OptimizerProfile assets, and team version control configuration. |
| 10. Writing Custom Rules | Extensibility Guide | Extending Scene Doctor with IAuditRule, AuditRule base class, AuditContext, FixHelpers, and automatic TypeCache registration. |
| 11. Showcase Scene: Fuzzy Harbor | Demo Environment | Detailed walkthrough of the golden hour coastal demo scene, district stress tests, and Play Mode cinematic flight controls. |
| 12. FAQ & Troubleshooting | Practical Solutions | Frequently asked questions, stats discrepancies, script compatibility, material atlasing caveats, and troubleshooting steps. |
At a Glance
| Property | Details |
|---|---|
| Open Dashboard | Window > Fuzzy Logic Labs > FuzzyOptimizer > Dashboard |
| One-Click Shortcut | Window > Fuzzy Logic Labs > FuzzyOptimizer > One-Click Optimize… |
| Render Pipelines | Universal Render Pipeline (URP 17+) and Built-in Render Pipeline |
| Target Unity Version | Unity 2022.3+ |
| Editor Namespaces | FuzzyLogicLabs.FuzzyOptimizer.Editor.* (Assemblies: FuzzyOptimizer.Editor) |
| Runtime Namespaces | FuzzyLogicLabs.FuzzyOptimizer.Runtime.* (Assemblies: FuzzyOptimizer.Runtime) |
| Generated Assets Directory | Assets/FuzzyOptimizer_Generated/ (Atlases, Combined meshes, HLOD, LODs, Colliders) |
| Project Settings File | ProjectSettings/FuzzyOptimizerSettings.json (Commit to version control to share team rules & ignores) |
| Revert & Session History | Library/FuzzyOptimizer/Sessions/ (Local session journal and scene backups) |
Quick Navigation
Ready to start optimizing your project? Jump straight into 01. Getting Started to run your first platform audit in under 60 seconds.