UAbilitySystemComponent::ServerSetReplicatedTargetData

#include "AbilitySystemComponent.h"

Access: public Specifiers: UFUNCTIONServerreliableWithValidation

Description

Reliable server RPC that sends confirmed targeting data from the client to the server. The server stores it and fires the ability's target data delegate.

Caveats & Gotchas

• Target data is not validated by default — the server trusts what the client sends. Override the target data validation logic to sanity-check positions and line-of-sight if exploits are a concern.
• Custom target data types must implement GetScriptStruct() and correctly support net serialization; failing to do so causes silent data corruption or crashes when serializing the handle over the network.

Signature

void ServerSetReplicatedTargetData(FGameplayAbilitySpecHandle AbilityHandle, FPredictionKey AbilityOriginalPredictionKey, const FGameplayAbilityTargetDataHandle& ReplicatedTargetDataHandle, FGameplayTag ApplicationTag, FPredictionKey CurrentPredictionKey)

Parameters

Name	Type	Description	Default
AbilityHandle	FGameplayAbilitySpecHandle	Handle to the ability spec that produced this target data.	—
AbilityOriginalPredictionKey	FPredictionKey	The prediction key that was active when the ability was activated.	—
ReplicatedTargetDataHandle	const FGameplayAbilityTargetDataHandle&	The target data collected by the targeting actor or task.	—
ApplicationTag	FGameplayTag	Optional tag describing how the target data should be applied.	—
CurrentPredictionKey	FPredictionKey	The prediction key active when the target data is confirmed.	—

Return Type

void

Example

Sending target data from a custom targeting task C++

// Typically called by UAbilityTask_WaitTargetData on player confirm.
// Direct use inside a custom task:
ASC->ServerSetReplicatedTargetData(
    AbilityHandle,
    OriginalPredictionKey,
    TargetDataHandle,
    FGameplayTag(),
    CurrentPredictionKey);

Version History

Introduced in: 4.15

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?