Skip to main content

14 - Data Asset

A UPrimaryDataAsset subclass: designer-authored data assets, clamped scalar, and a derived function computed from the data.

Full source​

include "CoreMinimal.h"
include "Engine/DataAsset.h"

uclass UExampleDataAsset : UPrimaryDataAsset meta: api=EXAMPLES_API
{
prop public float Damage EditAnywhere BlueprintReadWrite category="Data" default=20.0f clamp=[1.0f, 500.0f]
prop public float FireRate EditAnywhere BlueprintReadWrite category="Data" default=1.0f clamp=[0.1f, 20.0f]
prop public FText DisplayName EditAnywhere BlueprintReadWrite category="Data"

method public float GetDPS() const {
return (float)Damage / FireRate;
}

method public virtual FPrimaryAssetId GetPrimaryAssetId() const override {
return FPrimaryAssetId(TEXT("ExampleDataAsset"), GetFName());
}
}

Line by line​

  • uclass UExampleDataAsset : UPrimaryDataAsset - a primary data asset (reference-safe, asset-manager-compatible).
  • prop public float Damage ... clamp=[1.0f, 500.0f] - designer edits a clamped range in the Details panel.
  • prop public float FireRate ... clamp=[0.1f, 20.0f] - clamped non-zero (guard against divide-by-zero downstream).
  • prop public FText DisplayName - a localized display name.
  • method public float GetDPS() const - derived stat; data assets with derived getters keep "don't trust stored stats, compute them" simple.
  • method public virtual FPrimaryAssetId GetPrimaryAssetId() const override - required by UPrimaryDataAsset; identifies the asset type.

Why a data asset​

  • Content-driven - designers create .uasset rows per weapon/skin/monster without touching code.
  • Reference-safe - you can hold TObjectPtr<UExampleDataAsset> refs on actors and swap them.
  • Asset manager - primary assets support async/streaming and cross-asset references.

The clamp pattern​

clamp=[min, max] on a numeric prop produces the corresponding editor clamp. It's the designer-proofing layer - see Property specifiers.

Next: 15 - Movement.