API Reference

Core types

TypeCategoryDescription
UCrimsonSkillTreeAssetTree data asset - nodes, graph config, presentations, connection paths
UCrimsonSkillTree_NodeAssetA single node - costs, activation conditions, node events, state
UCrimsonSkillTree_EdgeAssetDirected edge; per-edge conditions, events, color overrides, LOD
UCrimsonSkillTreeManagerRuntimeReplicated component: budgets, levels, RPCs, loadouts, save data
UCrimsonSkillTreeBlueprintLibraryRuntimeBP helpers - node lookup, cost formatting, simulation

Host contract

The actor that hosts a UCrimsonSkillTreeManager must implement `ICrimsonSkillTreeInterface` (all three methods are BlueprintNativeEvent). The manager calls these on its owning actor to resolve the logical effect owner; without the interface, initialization fails (crash in development builds, silent no-op in shipping - see Quick Start step 2).

MethodReturns / purpose
GetSkillTreeOwner()The actor that logically owns the tree's effects - typically the controlled Pawn/Character
GetSkillTreeOwnerCharacter()The owning ACharacter (used by character-scoped events such as float-property modifiers)
GetSkillTreeManagerComponent()The host's UCrimsonSkillTreeManager instance

Sub-node bases

TypePurpose
UCrimsonSkillTree_ActivationConditionBasePrerequisite check before a node activates
UCrimsonSkillTree_NodeEventBaseEffect fired on level-up / level-down / reset
UCrimsonSkillTree_EdgeConditionBase / UCrimsonSkillTree_EdgeEventBaseEdge-scoped condition / event
FNodeResourceCost / FNodeCostDefinitionA cost (flat or curve-scaled) and its resource source

Connection line styles

TypeDescription
UCrimsonSkillTreeWidget_LineDrawingPolicyBaseAbstract, swappable connection-line strategy (GraphConfig.LineDrawingPolicy)
USkillTreeLineDrawingPolicy_StraightLine / _ElbowLineBuilt-in straight and elbow styles
UCrimsonSkillTreeWidget_LineDrawingPolicy_SplineMaterial-capable, designer-authored bezier connections
UCrimsonSkillTreeWidget_SplineConnectionRuntime widget painting one spline connection (material strip / color fallback)
FCrimsonSkillTree_ConnectionPathPer-connection authored path (points, anchors, material) on ConnectionPaths
FCrimsonSkillTree_SplineControlPointOne control point: position + arrive/leave tangents + ECrimsonSplineTangentMode
ECrimsonConnectionAnchorMode / ECrimsonSplineTangentModeAttach mode and tangent mode enums

Widgets

TypeDescription
UCrimsonSkillTreeWidget_NodePer-node widget primitive; subclass to customize appearance (On Update Node Appearance / On Node Hovered)
UCrimsonSkillTreeWidget_DecorationVisual-graph decoration widget (panel / header / divider)
UCrimsonSkillTreeWidget_NodeTooltipTooltip showing costs, conditions, and event descriptions
Screen + canvasUCrimsonCoreSkillTreeScreen / UCrimsonCoreSkillTreeGraph - the ready-made runtime UI, in the CrimsonCore plugin

Runtime structs & enums

TypeDescription
FSkillNodeChangeRequestA single node action in a batch (NodeGuid + ActionType)
FSkillTreeLoadoutNamed snapshot of node levels in a tree
FCrimsonSkillTree_SaveGameData / _SaveGameNodeStatePlain save structs (in CrimsonSkillTree_SaveData.h)
ECrimsonSkillNodeActionTypeActivate / Deactivate / IncrementLevel / DecrementLevel
ECrimsonNodeStateUnSet / Set / Max / Suppressed

Config & extension

TypeDescription
UCrimsonSkillTreeSettingsProject Settings -> Crimson -> Crimson Skill Tree
UGameFeatureAction_AddCrimsonSkillTreeGame Feature action injecting a tree into an actor at runtime

Built-in node events & conditions

TypeEffect / Check
UCrimsonSkillTree_NodeEvent_ApplyGameplayEffectApplies/removes a GE scaled to the node level
UCrimsonSkillTree_NodeEvent_GrantGameplayAbilityGrants/removes a Gameplay Ability
UCrimsonSkillTree_NodeEvent_ModifyCharacterFloatPropertyAdds/subtracts a named float property on the owner
UCrimsonSkillTree_ActivationCondition_ParentLevelParent node at/above a minimum level
UCrimsonSkillTree_ActivationCondition_AttributeRequirementA GAS attribute meets a threshold
UCrimsonSkillTree_ActivationCondition_ResourcePointsSpentA minimum number of points spent in the tree
UCrimsonSkillTree_Condition_CompositeBase (+ _AND / _OR)Combine conditions with AND / OR