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 byUPrimaryDataAsset; identifies the asset type.
Why a data asset
- Content-driven - designers create
.uassetrows 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.