Updated to version 1.0.1. Aesthetic adjustments have been made to the prompts and function category names.

Author: Pavreally

Plugins/ComponentDynamicAttributes/ComponentDynamicAttributes.uplugin

@@ -1,7 +1,7 @@
 {
 	"FileVersion": 3,
 	"Version": 1,
-	"VersionName": "1.0",
+	"VersionName": "1.0.1",
 	"FriendlyName": "Component Dynamic Attributes",
 	"Description": "Unreal Engine 5 Actor component for dynamic attribute management in single-player games.Numeric attributes only — nothing extra!",
 	"Category": "Experimental",

Plugins/ComponentDynamicAttributes/Content/B_CDA_ActorDemo.uasset

@@ -13,7 +13,7 @@ void FComponentDynamicAttributesModule::StartupModule()
 {
 	// This code will execute after your module is loaded into memory; the exact timing is specified in the .uplugin file per-module
 
-	// Adding a path to plugin tags - fixed to use correct plugin directory
+	// Adding a path to plugin tags
 	UGameplayTagsManager::Get().AddTagIniSearchPath(
 		FPaths::ProjectPluginsDir() / TEXT("ComponentDynamicAttributes/Config/Tags"));
 }

Plugins/ComponentDynamicAttributes/Source/ComponentDynamicAttributes/Private/ComponentDynamicAttributes.cpp

@@ -9,13 +9,13 @@ void UActorCDA::InitializeAttributes()
 	Attributes.Reset();
 	AttributeDefinitions.Reset();
 
-	if (AttributesData.IsEmpty())
+	if (RegisteredAttributeAssets.IsEmpty())
 	{
 		return;
 	}
 
 	int32 TotalDefinitions = 0;
-	for (const TObjectPtr<UAttributesDataAssetCDA>& DataAsset : AttributesData)
+	for (const TObjectPtr<UAttributesDataAssetCDA>& DataAsset : RegisteredAttributeAssets)
 	{
 		if (IsValid(DataAsset))
 		{
@@ -26,7 +26,7 @@ void UActorCDA::InitializeAttributes()
 	Attributes.Reserve(TotalDefinitions);
 	AttributeDefinitions.Reserve(TotalDefinitions);
 
-	for (const TObjectPtr<UAttributesDataAssetCDA>& DataAsset : AttributesData)
+	for (const TObjectPtr<UAttributesDataAssetCDA>& DataAsset : RegisteredAttributeAssets)
 	{
 		if (!IsValid(DataAsset))
 		{

Plugins/ComponentDynamicAttributes/Source/ComponentDynamicAttributes/Private/Components/ActorCDA_Init.cpp

@@ -27,11 +27,11 @@ float UActorCDA::GetCurrentValue(FGameplayTag Tag)
 	return Attributes[Index].CurrentValue;
 }
 
-void UActorCDA::SetAttribute(FGameplayTag Tag, const FAttributeRuntimeDataCDA& NewAttribute)
+void UActorCDA::RegisterAttribute(FGameplayTag Tag, const FAttributeRuntimeDataCDA& NewAttribute)
 {
 	if (!Tag.IsValid())
 	{
-		UE_LOG(LogComponentDynamicAttributes, Warning, TEXT("ActorCDA::SetAttribute - Invalid GameplayTag: %s"), *Tag.ToString());
+		UE_LOG(LogComponentDynamicAttributes, Warning, TEXT("ActorCDA::RegisterAttribute - Invalid GameplayTag: %s"), *Tag.ToString());
 		return;
 	}
 

Plugins/ComponentDynamicAttributes/Source/ComponentDynamicAttributes/Private/Components/ActorCDA_Runtime.cpp

@@ -0,0 +1,4 @@
+// Pavel Gornostaev <https://github.com/Pavreally>
+
+#include "Interfaces/AttributeModifierInterface.h"
+

Plugins/ComponentDynamicAttributes/Source/ComponentDynamicAttributes/Private/Interfaces/AttributeModifierInterface.cpp

@@ -32,143 +32,159 @@ class COMPONENTDYNAMICATTRIBUTES_API UActorCDA : public UActorComponent
 	UActorCDA();
 
 	// Array of data assets used to initialize attributes.
-	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
-	TArray<TObjectPtr<UAttributesDataAssetCDA>> AttributesData;
+	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	TArray<TObjectPtr<UAttributesDataAssetCDA>> RegisteredAttributeAssets;
 
 	// Runtime attribute storage for fast iteration.
-	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	TArray<FAttributeRuntimeDataCDA> Attributes;
 
 	// Index lookup for attributes by gameplay tag.
-	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	TMap<FGameplayTag, int32> AttributeIndex;
 
 	// Event broadcast when an attribute's value changes.
-	UPROPERTY(BlueprintAssignable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UPROPERTY(BlueprintAssignable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	FOnAttributeChangedCDA OnAttributeChangedCDA;
 
 	/**
 	 * Get the runtime data for an attribute.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @return The attribute's runtime data, or default if not found.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @return The attribute's runtime data, or a default-initialized struct if not found
 	 */
-	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	FAttributeRuntimeDataCDA GetAttribute(FGameplayTag Tag);
 
 	/**
 	 * Get only the current value of an attribute.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @return The current value, or 0.0f if not found.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @return The current value, or 0.0f if the attribute was not found
 	 */
-	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	float GetCurrentValue(FGameplayTag Tag);
 
 	/**
-	 * Set an attribute's runtime data.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @param NewAttribute The new runtime data to set.
+	 * Register an attribute's runtime data.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @param NewAttribute The runtime data to register or replace
 	 */
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
-	void SetAttribute(FGameplayTag Tag, const FAttributeRuntimeDataCDA& NewAttribute);
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	void RegisterAttribute(FGameplayTag Tag, const FAttributeRuntimeDataCDA& NewAttribute);
 
 	/**
-	 * Check if an attribute exists.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @return True if the attribute exists.
+	 * Check if an attribute exists in runtime storage.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @return true if the attribute exists
 	 */
-	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	bool HasAttribute(FGameplayTag Tag) const;
 
 	/**
-	 * Remove an attribute.
-	 * @param Tag The gameplay tag of the attribute.
+	 * Remove an attribute from runtime storage.
+	 *
+	 * @param Tag The gameplay tag of the attribute to remove
 	 */
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	void RemoveAttribute(FGameplayTag Tag);
 
-	// Remove all attributes.
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	/**
+	 * Remove all attributes from runtime storage.
+	 */
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	void RemoveAllAttributes();
 
 	/**
 	 * Edit an attribute's current value with an operation.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @param Operation The operation to perform.
-	 * @param Value The value to apply.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @param Operation The operation to perform
+	 * @param Value The value to apply
 	 */
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	void EditCurrentValue(FGameplayTag Tag, EAttributeOperationCDA Operation, float Value);
 
 	/**
 	 * Edit an attribute's base value with an operation.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @param Operation The operation to perform.
-	 * @param Value The value to apply.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @param Operation The operation to perform
+	 * @param Value The value to apply
 	 */
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	void EditBaseValue(FGameplayTag Tag, EAttributeOperationCDA Operation, float Value);
 
 	/**
 	 * Edit an attribute's minimum value with an operation.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @param Operation The operation to perform.
-	 * @param Value The value to apply.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @param Operation The operation to perform
+	 * @param Value The value to apply
 	 */
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	void EditMinValue(FGameplayTag Tag, EAttributeOperationCDA Operation, float Value);
 
 	/**
 	 * Edit an attribute's maximum value with an operation.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @param Operation The operation to perform.
-	 * @param Value The value to apply.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @param Operation The operation to perform
+	 * @param Value The value to apply
 	 */
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	void EditMaxValue(FGameplayTag Tag, EAttributeOperationCDA Operation, float Value);
 
 	/**
 	 * Add a modifier to an attribute.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @param Modifier The modifier to add.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @param Modifier The modifier to add
 	 */
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	void AddModifier(FGameplayTag Tag, const FAttributeModifierCDA& Modifier);
 
 	/**
 	 * Remove a specific modifier from an attribute.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @param Modifier The modifier to remove.
-	 * @return True if the modifier was found and removed.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @param Modifier The modifier to remove
+	 * @return true if the modifier was found and removed
 	 */
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	bool RemoveModifier(FGameplayTag Tag, const FAttributeModifierCDA& Modifier);
 
 	/**
-	 * Remove all modifiers from a source.
-	 * @param Source The source tag of modifiers to remove.
+	 * Remove all modifiers originating from a specific source tag.
+	 *
+	 * @param Source The source tag whose modifiers will be removed
 	 */
-	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintCallable, Category = "Dynamic Attributes CDA", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	void RemoveModifiersFromSource(FGameplayTag Source);
 
 	/**
 	 * Get an attribute's base, min, and max values from its level table.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @param Level The level to query.
-	 * @param OutBaseValue The base value at the specified level.
-	 * @param OutMinValue The minimum value at the specified level.
-	 * @param OutMaxValue The maximum value at the specified level.
-	 * @return True if the row was found.
-	 */
-	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes | Scaling", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @param Level The level to query
+	 * @param OutBaseValue The base value at the specified level (output)
+	 * @param OutMinValue The minimum value at the specified level (output)
+	 * @param OutMaxValue The maximum value at the specified level (output)
+	 * @return true if the row was found in the level table
+	 */
+	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes CDA | Scaling", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	bool GetAttributeValuesFromLevelTable(FGameplayTag Tag, int32 Level, float& OutBaseValue, float& OutMinValue, float& OutMaxValue) const;
 
 	/**
 	 * Get an attribute's value from its curve table.
-	 * @param Tag The gameplay tag of the attribute.
-	 * @param Level The level to evaluate.
-	 * @return The interpolated value at the specified level.
+	 *
+	 * @param Tag The gameplay tag of the attribute
+	 * @param Level The level to evaluate
+	 * @return The interpolated value at the specified level
 	 */
-	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes | Scaling", meta = (Keywords = "CDA, Component Dynamic Attributes"))
+	UFUNCTION(BlueprintPure, Category = "Dynamic Attributes CDA | Scaling", meta = (Keywords = "CDA, Component Dynamic Attributes"))
 	float GetAttributeValueFromCurve(FGameplayTag Tag, int32 Level) const;
 
 protected:
@@ -179,31 +195,72 @@ class COMPONENTDYNAMICATTRIBUTES_API UActorCDA : public UActorComponent
 	virtual void InitializeComponent() override;
 
 private:
-	// Initialize attributes from data assets.
+	/**
+	 * Initialize attributes from configured data assets and prepare runtime storage.
+	 * Called from component initialization path.
+	 */
 	void InitializeAttributes();
 
-	// Try to get the index of an attribute by tag.
+	/**
+	 * Try to get the index of an attribute by tag.
+	 *
+	 * @param Tag The attribute gameplay tag to look up
+	 * @param OutIndex Output index if found
+	 * @return true if the attribute exists in runtime storage
+	 */
 	bool TryGetAttributeIndex(FGameplayTag Tag, int32& OutIndex) const;
 
-	// Get the definition of an attribute.
+	/**
+	 * Get the definition of an attribute from cached definitions.
+	 *
+	 * @param Tag The attribute gameplay tag
+	 * @return Pointer to the definition or nullptr if not found
+	 */
 	const FAttributeDefinitionCDA* GetAttributeDefinition(FGameplayTag Tag) const;
 
-	// Add an attribute definition.
+	/**
+	 * Add an attribute definition to the internal definition table.
+	 *
+	 * @param Definition Definition to add
+	 */
 	void AddAttributeDefinition(const FAttributeDefinitionCDA& Definition);
 
-	// Remove an attribute by index.
+	/**
+	 * Remove an attribute by its runtime index.
+	 *
+	 * @param Index Index of the attribute to remove
+	 */
 	void RemoveAttributeByIndex(int32 Index);
 
-	// Recalculate an attribute if needed.
+	/**
+	 * Recalculate an attribute's derived values if needed.
+	 *
+	 * @param Tag Attribute gameplay tag
+	 * @param Index Runtime index of the attribute to recalc
+	 */
 	void RecalculateAttributeIfNeeded(FGameplayTag Tag, int32 Index);
 
-	// Apply an operation to a float value.
+	/**
+	 * Apply an operation (add, multiply, set, etc.) to a float target value.
+	 *
+	 * @param TargetValue Value to modify (in/out)
+	 * @param Operation Operation to perform
+	 * @param Value Operand value for the operation
+	 */
 	void ApplyOperation(float& TargetValue, EAttributeOperationCDA Operation, float Value) const;
 
-	// Broadcast value change if different.
+	/**
+	 * Broadcast value change if the value actually changed.
+	 *
+	 * @param Tag Attribute tag
+	 * @param OldValue Previous value
+	 * @param NewValue New calculated value
+	 */
 	void BroadcastIfValueChanged(FGameplayTag Tag, float OldValue, float NewValue);
 
-	// Storage for attribute definitions.
+	/**
+	 * Storage for attribute definitions used to initialize runtime attributes.
+	 */
 	UPROPERTY()
 	TArray<FAttributeDefinitionCDA> AttributeDefinitions;