struct

AbilitySystemStateComponent

Module
Game
Header
#include "Game/Components/AbilitySystemStateComponent.h"
Namespace
Mowo
Reflection
Reflected by MowoHeaderTool

Properties

TypeNameDescription
floathealthsnapshot. These are the CURRENT (aggregated) attribute values. Default 0.0f.
floatmaxHealthDefault 0.0f.
floatmanaDefault 0.0f.
floatmaxManaDefault 0.0f.
floatstaminaDefault 0.0f.
floatmaxStaminaDefault 0.0f.
uint32_tstatusFlagsDiscrete status word — bit 0 = dead, higher bits = game-defined status flags. Rides the reliable channel so a dropped snapshot never strands a client on a stale death/status. Default 0.
std::vector<uint32_t>grantedAbilitiesEvery ability the server has granted, as wire ids (MAbilitySystemComponent::AbilityWireId — FNV-1a32 of the tag path, the same id the activation RPCs carry). A client uses it to refuse an activation the server would reject anyway, saving the round trip.
std::vector<uint32_t>cooldownAbilitiesLive cooldowns as two INDEX-ALIGNED arrays: ids and the seconds left on each. Two arrays rather than one array of pairs because the codec takes fixed-width ELEMENTS — a struct entry needs a per-element codec, and a uint64 (id<<32 | ms) is not in the replicable type set either. Readers must walk min(size, size): a lost or reordered update must not read one array past the other.
std::vector<float>cooldownRemaining
uint32_tlastRequestedAbilityRuntime-only bookkeeping (not replicated as fields — driven by the RPCs). Default 0.
uint32_tlastActivatedAbilityDefault 0.
uint32_tabilityActivationsDefault 0.
uint16_tlastRequestedPredictionKeyDefault 0.
uint16_tlastConfirmedPredictionKeyDefault 0.
uint16_tlastRejectedPredictionKeyDefault 0.
uint32_tlastCueIdLast replicated cue, kept for observers and tests. The cue itself is dispatched the moment the RPC lands, not buffered — cues are cosmetic and a frame of queueing buys nothing, while a queue would need a policy for what to drop when several arrive in one tick. Default 0.
uint32_tlastCueEventDefault 0.
floatlastCueMagnitudeDefault 0.0f.
Vec3lastCueLocation
uint32_tcuesReceivedDefault 0.
uint32_tcuesUnresolvedDefault 0.

Public functions

ReturnsNameDescription
floatCooldownForSeconds left on wireId, 0 when it is not on cooldown.
boolHasGrantedAbility
voidServerActivateAbilityClient → server: "the owning client wants to activate ability N, and it has already predicted the result under prediction key K." MFUNCTION(Server) auto-installs an OwnerOnly policy, so only the peer that owns the pawn may send it.
voidMulticastAbilityActivatedServer → every client: "ability N activated." Runs on the server and on each ghost, so cosmetic reactions (cues, montages) can play everywhere.
voidClientConfirmAbilityServer → owning client: the predicted activation stands.
voidClientRejectAbilityServer → owning client: the predicted activation was refused.
voidMulticastGameplayCueServer → every client: "this cosmetic cue fired." Reliable, because a dropped death cue leaves a corpse with no effect on it and nothing later repairs it — a cue is an edge, not a state a snapshot can re-converge.

Function details

CooldownFor

C++
float CooldownFor(uint32_t wireId) const

Seconds left on wireId, 0 when it is not on cooldown. The pairing invariant is enforced HERE so every caller gets it right.

HasGrantedAbility

C++
bool HasGrantedAbility(uint32_t wireId) const

ServerActivateAbility

C++
void ServerActivateAbility(uint32_t abilityId, uint16_t predictionKey)

Client → server: "the owning client wants to activate ability N, and it has already predicted the result under prediction key K." MFUNCTION(Server) auto-installs an OwnerOnly policy, so only the peer that owns the pawn may send it. The server validates + activates on the real ASC and answers the owning client with a confirm or a reject carrying the same key, so the client reconciles the exact activation it predicted.

MulticastAbilityActivated

C++
void MulticastAbilityActivated(uint32_t abilityId)

Server → every client: "ability N activated." Runs on the server and on each ghost, so cosmetic reactions (cues, montages) can play everywhere.

ClientConfirmAbility

C++
void ClientConfirmAbility(uint32_t abilityId, uint16_t predictionKey)

Server → owning client: the predicted activation stands. The client drops the retained baseline; the replicated attributes converge the values.

ClientRejectAbility

C++
void ClientRejectAbility(uint32_t abilityId, uint16_t predictionKey)

Server → owning client: the predicted activation was refused. The client rolls its ASC back to the captured baseline for that key.

MulticastGameplayCue

C++
void MulticastGameplayCue(uint32_t cueId, uint32_t cueEvent, Vec3 location, float magnitude)

Server → every client: "this cosmetic cue fired." Reliable, because a dropped death cue leaves a corpse with no effect on it and nothing later repairs it — a cue is an edge, not a state a snapshot can re-converge. The tag travels as FGameplayCueDispatcher::CueWireId (FNV-1a32 of the path); a receiver that has never named that tag cannot resolve it, so the cue is counted in cuesUnresolved and dropped rather than guessed at. The location rides along because a cue plays in the WORLD, not on the owner: an impact effect belongs at the hit, not at the actor's pivot.

Generated from Game/Components/AbilitySystemStateComponent.h via game.json · Nov 5, 2026Version 1.0.0