SmartRefs
SmartRefs›Core Features›Features & Node Reference

Features & Node Reference

Stable

In-depth guide to async loading, batch loading, and unload policies.

Features & Node Reference

SmartRefs provides a complete toolkit for managing asset lifecycles in Blueprints and C++.

Core Nodes#

1. Async Load Smart Ref#

Loads a single soft object or class reference:

  • Soft Reference: The TSoftObjectPtr or TSoftClassPtr to load.
  • Priority: High, Normal, or Low.
  • On Loaded: Fires when the asset finishes streaming from disk.
  • Loaded Asset: Typed object reference ready for immediate gameplay use.

2. Batch Load Smart Refs#

Loads an entire array of soft references simultaneously:

  • Soft References: Array of soft pointers to load.
  • On Progress: Fires as each individual asset loads (providing a 0.0 to 1.0 progress float for loading bars).
  • On All Loaded: Fires once all assets in the batch are ready.
Batch Loading Node
Click to expand
Visual Guide: Batch Loading Node

3. Release Smart Ref#

Manually unloads an asset from memory when no longer needed (e.g. when an enemy is defeated or a level zone is exited).