Configuration¶

Asset Atlas settings are found in Project Settings > Plugins > Asset Atlas. This reference covers all available options.

Accessing Settings¶

Via Project Settings¶

Edit > Project Settings
Scroll to Plugins section
Click Asset Atlas

Via Asset Atlas¶

Click the ⚙ (gear) button in the Asset Atlas header bar to open settings directly.

Visualization Settings¶

Control how the dependency graph is displayed.

Setting	Type	Default	Description
Default Cluster Mode	String	"Folder"	How to group assets (Folder, Type, or None)
Max Visible Nodes	Integer	300	Maximum nodes displayed at once (50-1000)
Start Clusters Collapsed	Boolean	true	Whether clusters start collapsed
Show Reference Counts	Boolean	true	Display in/out counts on nodes
Show Asset Sizes	Boolean	true	Display file sizes on nodes

Max Visible Nodes¶

For performance, Asset Atlas limits visible nodes. When exceeded:

Less important nodes are hidden
Use filters to focus on specific areas
Expand clusters to see hidden nodes

Filtering Settings¶

Configure default analysis scope.

Setting	Type	Default	Description
Excluded Folders	Array	["/Game/Developers"]	Folders to exclude from analysis
Exclude Editor Assets	Boolean	true	Skip editor-only assets
Include External Packages	Boolean	false	Include plugin/engine assets

Excluded Folders¶

Add folder paths to exclude from analysis:

/Game/Developers
/Game/Test
/Game/_Debug

Useful for excluding:

Developer sandbox folders
Test/debug content
Temporary assets

Grading Settings¶

Configure health score calculation.

Setting	Type	Default	Description
Grading Preset	Dropdown	"Balanced"	Built-in or custom preset

Available Presets¶

Strict - Production-ready standards
Balanced - Good for most projects
Lenient - Early development/prototyping
SampleProject - For Epic sample projects
[Custom] - JSON files from Config/Presets

See Grading System for details.

Scan Settings¶

Configure how asset scanning works.

Setting	Type	Default	Description
Auto Scan on Open	Boolean	false	Automatically scan when opening Atlas
Incremental Updates	Boolean	true	Update graph on asset changes

Auto Scan¶

When enabled, Asset Atlas automatically scans when:

Opening the Atlas tab
Project assets change significantly

Incremental Updates¶

When enabled, the graph updates automatically when:

Assets are added or removed
Dependencies change
Without requiring full rescan

Asset Optics Integration¶

Configure optional Asset Optics integration.

Setting	Type	Default	Description
Enable Integration	Boolean	false	Enable Asset Optics features
Project ID	Integer	0	Asset Optics project identifier
Backend URL	String	""	API endpoint (blank for default)
Show Task Counts	Boolean	true	Display task badges
Show Checklist Progress	Boolean	true	Display checklist indicators
Show Sync Status	Boolean	true	Display sync badges

Requires Asset Optics

These settings only apply when Asset Optics plugin is installed.

See Asset Optics Integration for setup details.

Performance Settings¶

Tune for large projects.

Setting	Type	Default	Description
Use Background Thread	Boolean	true	Scan in background thread
Change Debounce (ms)	Integer	100	Delay before processing changes (50-1000)
Cache Scan Results	Boolean	true	Cache results to disk

Background Thread¶

Enabled by default. Prevents editor freezing during scans.

Change Debounce¶

How long to wait after asset changes before updating. Lower values = more responsive, higher values = better performance.

Cache Scan Results¶

When enabled:

Results persist between editor sessions
Faster startup on subsequent opens
Cache invalidated when assets change

User State¶

These settings track user state (not editable):

Setting	Description
Upsell Banner Dismissed	Whether the ecosystem banner was dismissed

Default Configuration¶

The default configuration file is at:

AssetAtlas/Config/DefaultAssetAtlas.ini

Project-specific overrides are saved to:

YourProject/Config/DefaultEditor.ini

Resetting to Defaults¶

To reset all settings:

Open Project Settings
Right-click the Asset Atlas section header
Select "Reset to Default"

Or delete the project config entries manually.

Troubleshooting Grading System