ue-data-assets-tables

To load Unreal Engine data assets asynchronously, use FStreamableManager to handle soft object references like TSoftObjectPtr. This approach prevents game thread stalls by requesting assets through soft pointers and loading them in the background before accessing the underlying objects.

UDataAsset stores complex, hierarchical object references and custom data structures, while UDataTable maps flat row-based data imported from CSV or JSON. Use UDataAsset for nested gameplay configurations and UDataTable for simple tabular item stats.

To set up UPrimaryDataAsset, define your C++ class inheriting from UPrimaryDataAsset, register it with the Asset Manager, and assign asset bundle names to soft references. This enables efficient grouped asynchronous loading for different contexts like UI versus gameplay.

Use TSoftObjectPtr instead of hard references in Unreal Engine when you want to defer asset loading to prevent memory bloat and initial load times. Soft pointers store asset paths without loading the actual data until explicitly requested via FStreamableManager.

Common pitfalls in Unreal Engine asset loading workflows include using hard references where soft pointers are needed, causing memory spikes, and failing to properly configure asset bundles for asynchronous loading. Synchronous loading on the game thread also leads to noticeable hitches.