RealDocs

UKismetSystemLibrary::Conv_SoftObjectReferenceToObject

function Engine Blueprint Since unknown
#include "Kismet/KismetSystemLibrary.h"
Access: public Specifiers: staticBlueprintPure

Description

Returns the already-loaded object a soft reference points to, or nullptr if it isn't currently loaded. Marked BlueprintInternalUseOnly — it backs the internal K2Node_ConvertAsset node rather than being placed directly from the palette.

Caveats & Gotchas

  • Does NOT load the asset — it only returns the object if it happens to already be resident in memory. Use LoadAsset_Blocking or an async load if you need to guarantee the asset is loaded first.
  • Because it's BlueprintInternalUseOnly, it won't appear in the normal Blueprint node search; it's emitted automatically when you drag a wire out of a Soft Object Reference pin into a pin expecting a hard object reference.
  • Returns nullptr both when the reference is unset and when it's set but simply not loaded yet — the two cases are indistinguishable from the return value alone.

Signature

static ENGINE_API UObject* Conv_SoftObjectReferenceToObject(const TSoftObjectPtr<UObject>& SoftObject)

Parameters

Name Type Description Default
SoftObject const TSoftObjectPtr<UObject>& The soft object reference to resolve.

Return Type

UObject*

Example

Use an already-loaded soft reference without forcing a load C++
UObject* MaybeLoaded = UKismetSystemLibrary::Conv_SoftObjectReferenceToObject(MySoftRef);
if (MaybeLoaded)
{
    // Safe to use immediately, no load was triggered
}

Version History

Introduced in: unknown

Version Status Notes
5.6 stable

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.