Skip to content
Tuxedo CatSTUDIO
Menu

Relationship Blueprint API

Review draft. This source page has not completed website editorial and release-specific verification.

URelationshipComponent exposes GetRelationshipValue, HasExplicitRelationshipWithTarget, GetRelationshipTargets, SetRelationshipValue, AddRelationshipValue, ResetRelationshipMetric, and ResetRelationshipWithTarget. Mutations return FRelationshipMutationResult with Changed, NoChange, or a rejected status.

Runtime Edit is available only from Relationship Director Runtime Controls and uses the existing authoritative Relationship Blueprint APIs. The separate Runtime Inspector is strictly read-only. Advanced Debug Override is native editor-only functionality and is intentionally not BlueprintCallable or available in shipping builds.

Normal Runtime Edit calls SetRelationshipValue, AddRelationshipValue, ResetRelationshipMetric, and ResetRelationshipWithTarget. Each returns FRelationshipMutationResult; inspect its status. Advanced Debug Override can exceed authored Floor/Ceiling only, never the absolute 0..100 domain, and its privileged seam has no Blueprint node. RelationshipDirectorProbabilityBridge is retired. Optional Probability-backed checks use DirectorBridge Relationship.Probability; see Integrations. Relationship core remains usable without either plugin.