API Reference

Every public type this plugin ships. Types owned by another module are marked.

Core types

Type	Kind	Purpose
`UCrimsonAbilitySystemComponent`	Component	The ASC. Cooldowns, modifiers, tag stacks, effect stacks, augment slots, input routing.
`UCrimsonGameplayAbility`	Ability	Base ability with activation policy/group, costs, configurable values, augment broadcast.
`UCrimsonAbilitySystemGlobals`	Globals	MUST be registered in `DefaultGame.ini`. Allocates `FCrimsonGameplayEffectContext`.
`FCrimsonGameplayEffectContext`	Struct	Effect context carrying ability source and augment provenance.
`UCrimsonAttributeSet`	Attribute set	Base for your attribute sets.
`UCrimsonAbilitySystemSettings`	Settings	Project Settings -> Crimson -> Crimson Ability System.
`UCrimsonAbilitySystemStatics`	Library	`GetSetByCallerMagnitudeFromHandle`, `GetAbilitySystemComponentFromTargetData`, `GetPredictedMontageDuration`.
`UCrimsonGlobalAbilitySystem`	Subsystem	Apply/remove an ability or effect across every ASC.
`UCrimsonAbilityTagRelationshipMapping`	Data asset	Static block/cancel relationships by tag.
`ICrimsonAbilitySourceInterface`	Interface	Lets a damage source describe itself to calculations.

Ability subclasses

Type	Key API
`UCrimsonGameplayAbility_WithCastTime`	`UpdateAbilityCastTime`, `GetCalculatedCastTime`, `ECrimsonAbilityCommitTime`.
`UCrimsonGameplayAbility_Toggle`	Activates and deactivates on alternating presses.
`UCrimsonGameplayAbility_Charges`	`GetMaxCharges`, `GetCurrentCharges`.
`UCrimsonGameplayAbility_Channeling`	`StartChanneling`, `StopChanneling`, `SetChannelTickInterval`, `SetMaxChannelTime`, `SetCancelOnMovement`.
`UCrimsonGamePhaseAbility`	A phase modelled as an ability. `GetGamePhaseTag`.

Costs

Type	Purpose
`UCrimsonAbilityCost`	Base. Override `K2_CheckCost` and `K2_ApplyCost`.
`UCrimsonAbilityCost_PlayerTagStack`	Charges a tag-stack resource.

Augments

Type	Purpose
`UCrimsonAbilityAugment`	The augment data asset - mutations, actions, stateful listeners.
`UCrimsonAugmentSubsystem`	World subsystem resolving augment definitions.
`UCrimsonAugmentAction`	One-shot action base. Override `Execute`.
`UCrimsonStatefulAugmentBase`	Stateful listener base. Override `Initialize`, `HandleAbilityEvent`, `OnRemoved`.
`UCrimsonAugmentActor`	Actor spawned by an augment. `GetOwningAbility`, `GetSnapshotedValue`.
`ICrimsonAugmentSpawnedActorInterface`	`InitializeAugmentActor` on spawned actors.
`UCrimsonAbilityContract`	Declares the properties an ability exposes.
`UCrimsonAbilityTask_SpawnAugmentActor`	Ability task for augment-owned actors.

Shipped actions: _ApplyGameplayEffect, _Chance, _Conditional, _ConsumeEffectStacks, _FindTargets, _GrantAndActivateAbility, _ModifyContext, _ModifySetByCaller, _ModifySpecAttribute, _ReduceCooldown, _SpawnActor.

Shipped stateful listeners: _ApplyGameplayEffect, _EventTrigger, _HitCounter, _ModifyTags, _ReplaceAbility, _StackConsumer.

Gameplay Effect components

Type	Purpose
`UCrimsonModifierGameplayEffectComponent`	Applies property modifiers from an effect.
`UCrimsonAccumulateGameplayEffectComponent`	Accumulates a value across applications.
`UCrimsonGameplayEffectComponent_ApplyToInstigator`	Also applies the effect to the instigator.
`UCrimsonGameplayEffectStackingSubsystem`	Stacking bookkeeping.

Combo system

Type	Purpose
`UCrimsonComboController`	The runtime driver. Add to the pawn.
`UCrimsonComboGraphAsset`	The authored graph - handshake, nodes, end points.
`UCrimsonComboTransitionCondition`	Per-step observer gating a transition's augments.
`UCrimsonComboEventBase`	Event base. Subclasses `_Augment`, `_GameplayCue`, `_GameplayEvent`, `_GameplayMessage`.
`UCrimsonComboPathLibrary`	`BuildComboPathTree`, `BuildComboPathForestFromGrants` for UI.
`UCrimsonInputTrigger_Combo`	Enhanced Input trigger with correct press/hold/release semantics.
`FCrimsonComboExtension`	UPROPERTY on `UCrimsonGameplayAbility` declaring rooted combos and the cancel window.
`FCrimsonComboTransition`	One edge - input, kind, charge window, fire mode, priority, conditional augments.
`FCrimsonComboRuntimeNode`	One step - ability class, phase boundaries, transition window, events.
`ECrimsonComboFireMode`	`IASA`, `PressBuffer`, `HoldBuffer`.
`ECrimsonComboInputKind`	`Tap`, `Hold`, `Release`.
`ECrimsonComboDirection`	`None`, `Forward`, `Back`, `Left`, `Right`, `Up`, `Down`.
`ECrimsonComboResetReason`	Why a combo ended - timeout, damage, death, interruption, and so on.

Combo controller functions

Function	Purpose
`HandleInputActionPressed` / `Released`	Route input. The third parameter marks a press defensive.
`IsComboActive` / `IsInCancelWindow`	State queries.
`GetCurrentCombo` / `GetCurrentNodeID` / `GetCurrentStepHandle`	What is running now.
`GrantDynamicCombo` / `RevokeComboGrant` / `UnlockComboGrant` / `LockComboGrant`	Runtime grant management. Server only.
`IsComboGranted` / `GetGrantedCombosFor`	Grant queries.
`GrantAugmentWithLifetime` / `RemoveAugmentFromCurrentStep` / `RemoveAllAugmentsFromCurrentStep`	Step-scoped augment control.
`AddDynamicEventToNode` / `RemoveDynamicEvent` / `RemoveDynamicEventsBySource`	Runtime event overlay.
`ResetCombo`	End the current combo with a reason.
`GetActiveHolds` / `GetAvailableComboInputs`	UI-facing state - charge bars, input prompts.
`GetSaveData` / `ApplySaveData`	Persist dynamic grants and events.
`SetMoveInputProvider`	C++ only. Supplies directional intent.

Persistence

Type	Purpose
`UCrimsonAbilityStateCarrierSubsystem`	Game instance subsystem holding a snapshot across travel.
`UCrimsonEffectPersistenceComponent`	Per-effect persistence bookkeeping.
`UCrimsonAbilityStatePersistenceSettings`	Project Settings -> Crimson -> Ability State Persistence.
`FCrimsonAbilitySystemStateSnapshot`	The captured state.

Base actors

Type	Derives from	Purpose
`ACrimsonAbilityCharacter`	`ACrimsonModularCharacter` (CrimsonCommon)	Character with ASC access and init callbacks.
`ACrimsonAbilityPlayerState`	`ACrimsonModularPlayerState` (CrimsonCommon)	Owns the ASC - the recommended pattern.
`ACrimsonAbilityPlayerController`	`ACrimsonModularPlayerController` (CrimsonCommon)	Typed ASC accessor.
`ACrimsonTaggedActor`	`AActor`	Actor carrying gameplay tags.

Settings

Setting	Default	Purpose
`bEnableComboSystem`	`false`	Master switch. Editor restart to apply.
`ComboInputMappingContext`	unset	The IMC catalog the combo input picker reads.
`MoveInputAction`	unset	Sampled at press time for `ECrimsonComboDirection`.
`DefaultInputBufferTTL`	`0.1`	Last resort in the buffer TTL chain.
`DefaultInputBufferCapacity`	`8`	Ring buffer size.
`MoveInputDeadZone`	`0.3`	Below this, direction resolves to `None`.
`ServerPingLeniencyCapSeconds`	`0.08`	Cap on server window tolerance.
`bDefaultResetOnDamageTaken`	`true`	Seeded into new combo assets.
`TapMaxHoldDuration`	`0.18`	Tap/Hold disambiguation threshold.
`RecentlyEndedBannerSeconds`	`1.5`	Dev-tools cosmetic only.

Gameplay tags this plugin defines

These are native tags declared by this plugin - you can rely on them existing.

Group	Tags
Activation failure	`Ability.ActivateFail.Cooldown`, `.Silenced`, `.IsDead`, `.ActivationGroup`, `.Charge.OutOfCharges`
Ability state	`Ability.State.Casting`, `.Channeling`, `.Interrupted`, `.Stunned`, `.Silenced`, `.Changed`, `.AbilityHandleChanged`
Ability properties	`Ability.Property.Cooldown`, `Ability.Property.PrimaryTargetCount`
Ability behavior	`Ability.Behavior.SurvivesDeath`
Augment events	`Augment.Event.OnActivate`, `.OnHit`, `.OnCrit`, `.OnKill`, `.OnEnd`, `.OnGranted`, `.OnRemoved`, `.OnOwnerDodge`, `.OnOwnerBlock`, `.OnOwnerDamageTaken`
Augment categories	`Augment.Category.Default`, `.Stat`, `.Behavior`, `.Defensive`, `.Trigger`, `.Visual`
Persistence	`Crimson.Persistence.Persist`, `Crimson.Persistence.DoNotPersist`
Status	`Status.Death`, `Status.Cheat.Invulnerable`, `Gameplay.AbilityInputBlocked`

Augment.Event.OnActivate does not reach combo conditions

It is broadcast during the step ability's activation, before the combo controller has registered that step - so the spec filter drops it. Use OnObservationBegin instead. How-To: Gate Combo Branches with Conditions documents the full reasoning and the workarounds.

Types owned by other modules

Listed for orientation. These are not shipped by this plugin.

Type	Home	Note
`UCrimsonAbilitySet`	CrimsonCommon	The data asset used to grant abilities, effects and attribute sets.
`FCrimsonAbilitySet_GrantedHandles`	CrimsonCommon	Revoke handle returned by a grant.
`ICrimsonAbilitySystemOwner`	CrimsonCommon	Interface the PlayerState implements.
`ACrimsonModularCharacter` / `PlayerState` / `PlayerController`	CrimsonCommon	Base classes this plugin's actors extend.
`UCrimsonHeroComponent`	CrimsonCore (requires all Crimson plugins)	Turnkey input routing including the defensive-input entry points. How-To: Tune Combo Input Feel shows the standalone equivalent.