v1.5.1 (#44)

* [AI] InvokeGameplayAbility ValueOrBBKey_GameplayTag (#28)

* [AI] InvokeGameplayAbility ValueOrBBKey_GameplayTag

* Update BTT_InvokeGameplayAbility.h

* GetMostDistantVector

* UEnemyTickOptimizerSubsystem

* Update EnemyTickOptimizerSubsystem.cpp

* [BPL] TurnOffActorCanEverAffectNavigation

* Revert "[BPL] TurnOffActorCanEverAffectNavigation"

This reverts commit 526179c.

* Add Capsule Trace for InterpolateToPosition

* Add InterpolateToPosition OutHit Result (#32)

* Split on modules (#33)

* UHLModules refactoring

* UHLDebugBlueprintLibrary

* UHLDebugSystem -> UHLDebug

* Update DefaultUnrealHelperLibrary.ini

* UHLDebug final

* UHLAI module

* UHLGAS part 1

* save

* UHLDebugSystem now separate system, UHLDebug now for UHL debugging

* fix

* fix AT_InterpolateToPosition

* Update DefaultUnrealHelperLibrary.ini

* [DebugSystem] fix initialize of DebugCategories that requires PlayerController

* fix build error

* fix redirector build error

* [Editor] UnrealHelperEditor -> UHLEditor

* [Editor] UnrealHelperEditor -> UHLEditor part 2

* update docs

* update docs

* finish FValueOrBBKeyDetails_GameplayTag, UHLAIEditor

* minor fixes

* [Debug] fix UI_UHL_DebugWidget ref

* [AI] RandomChance scalable (#35)

* [AI] RandomChance scalable

* RandomChance scalable finish

* [Debug] fix UHLDebugWidget crash

* [AI] RandomChance hide debug

* [AI] RandomChance show parent node name

* [DebugSystem] DebugCategories dropdown menu (#36)

* [DebugSystem] add DebugSystemEditor module with dropdown menu for quick debug categories change

* small fixes

* [AnimNotifies] AN_AttachWithUniqueId, FindAttachedActorByTag

* CommonMaps with introspection (#37)

* [CommonMaps] with introspection

* try to customize SearchFolder prop to get realtivepath work

* contentdir found

* CommonMaps finish

* Update CommonMapsDeveloperSettings.h

* [AnimNotifies] AN_AttachWithUniqueId

* [GAS] AA_TryActivateAbilityAndWait

* [BPL] RandomValueInInterval

* [BPL] InRangeToLocation

* [GAS] AA_TryActivateAbilityAndWait fix onEndAbility

* BTD_GameplayEffectCooldown (#39)

* BTD_GameplayEffectCooldown

* save

* [UHLStateTree] module creation, STC_HasCooldown/STT_SetTagCooldown, UHLStateTreeAIComponent

* [UHLStateTree] cooldown bFinishTask

* [AI] fix build error BTD_RandomChance

* [UHLStateTree] move to separate plugin

* [FAB] package plugin fixes

* [UHLGAS] ANS_UHLGAS_TimedNiagaraEffect

* [UHLAI] share TurnTo with UHLStateTree

* [UHLGAS] ANS_UHLGAS_TimedNiagaraEffect fixup categories

* [UHLGAS] Add new Options for ability input cache (#38)

* Modify AbilityInputCache

* temp

* fixes

---------

Co-authored-by: Ciberus <ciberus.ps@gmail.com>

* [BPL] enemy movement dirs calculation - GetEnemyMovementDirectionRelativeToCharacter, GetMovementDirection, ConvertMovementInputVectorToDirection

* [UHLGAS] GameplayAbility "bCancelManually"

* Update README.md

* [UHLGAS] WaitAbilityDeactivate

* [UHLGAS] TryActivateAbilityAndWait payload with InstancedStructs

* [UHLGAS] UHLGameplayAbility->GetIsCancelRequested

* [UHLGAS] improve cache naming

* [UnrealHelperLibrary] ANS_ChangeRotationRate

* [UHLCharacter] UHLCharacterMovementComponent basic setup

* [UHLGAS] AA_WaitAttributeChangeRatioThreshold

* [UHLEditor] fix void class in custom icons crash

* [UHLDebugSystem] fix bug "ByDefaultEnabledInBuildTypes" DebugCategory should enable in build for categories that "bRequiresPlayerControllerToEnable"

* [UHLGAS] fix build error AbilityTask_WaitAttributeChangeRatioThreshold

* [UHL] ANS_SpawnAndSwitchPlayerCamera

* [UHL] ANS_ChangeCharacterCapsule, ANS_ChangeNamedCapsule

* [UHLCharacter] fix build

* [UHLDebugSystem] fix ShortName -> Name PropertyRedirects

* [UHLCharacter] AUHLBaseCharacterWithASC add bDontInitOnSameControllerTwice

* [UHLDebugSystem] fix UHLDebugCategory.ShortName->Name migration

* [UHL] ANS_ChangeCapsuleBase add collision settings

* [UHLDebugSystem] fix scrolling of UHLDebugCategoriesListWidget

* [UHL] IsWorldPartitionEnabled, IsLevelHasSublevels

---------

Co-authored-by: Daniel Ekimov <dricodyss@icloud.com>
Co-authored-by: Daniel <124425361+DRICODYSS@users.noreply.github.com>

Author: Ciberusps

Config/DefaultUnrealHelperLibrary.ini

@@ -31,7 +31,6 @@
 +PropertyRedirects=(OldName="/Script/UnrealHelperLibrary.UHLDebugCategory.bForceDeactivateOnGameStart",NewName="/Script/UnrealHelperLibrary.UHLDebugCategory.bForceComponentsDeactivateOnEnd")
 +PropertyRedirects=(OldName="/Script/UnrealHelperLibrary.UHLDebugCategory.bForceDeactivateOnEnd",NewName="/Script/UnrealHelperLibrary.UHLDebugCategory.bForceComponentsDeactivateOnEnd")
 +PropertyRedirects=(OldName="/Script/UnrealHelperLibrary.UHLDebugSubsystemSettings.GameplayTagTableList",NewName="/Script/UnrealHelperLibrary.UHLDebugSubsystemSettings.DebugCategoriesGameplayTagsTableList")
-+PropertyRedirects=(OldName="/Script/UnrealHelperLibrary.UHLDebugCategory.ShortName",NewName="/Script/UnrealHelperLibrary.UHLDebugCategory.Name")
 +PropertyRedirects=(OldName="/Script/UnrealHelperLibrary.UHLDebugSubsystemSettings.bExcludeUHLDebugCategories",NewName="/Script/UnrealHelperLibrary.UHLDebugSubsystemSettings.bExcludeDefaultUHLDebugCategories")
 +PropertyRedirects=(OldName="/Script/UnrealHelperLibrary.UHLDebugCategory.ByDefaultEnabledIn",NewName="/Script/UnrealHelperLibrary.UHLDebugCategory.ByDefaultEnabledInBuildTypes")
 +PropertyRedirects=(OldName="/Script/UnrealHelperLibrary.UHLAbilitySystemComponent.InitialActiveAbilities",NewName="/Script/UnrealHelperLibrary.UHLAbilitySystemComponent.ActiveAbilitiesOnStart")
@@ -67,6 +66,7 @@
 +ClassRedirects=(OldName="/Script/UnrealHelperLibrary.UHLDebugCategoriesListWidget",NewName="/Script/UHLDebugSystem.UHLDebugCategoriesListWidget")
 +ClassRedirects=(OldName="/Script/UnrealHelperLibrary.UHLDebugWidget",NewName="/Script/UHLDebug.UHLDebugWidget")
 +FunctionRedirects=(OldName="/Script/UnrealHelperLibrary.UnrealHelperLibraryBPL.IsUHLDebugCategoryEnabled",NewName="/Script/UHLDebugSystem.UHLDebugBlueprintLibrary.IsUHLDebugCategoryEnabled")
++PropertyRedirects=(OldName="/Script/UHLDebugSystem.UHLDebugCategory.ShortName",NewName="/Script/UHLDebugSystem.UHLDebugCategory.Name")
 
 ; UHLAI
 +ClassRedirects=(OldName="/Script/UnrealHelperLibrary.UHLAIPerceptionComponent",NewName="/Script/UHLAI.UHLAIPerceptionComponent")
@@ -202,3 +202,6 @@
 +ClassRedirects=(OldName="/Script/UnrealHelperLibrary.AN_AttachWithUniqueId",NewName="/Script/UnrealHelperLibrary.AN_AttachActorWithUniqueId")
 +FunctionRedirects=(OldName="/Script/UnrealHelperLibrary.UnrealHelperLibraryBPL.IsOtherCharacterInRange",NewName="/Script/UnrealHelperLibrary.UnrealHelperLibraryBPL.InRangeToOtherCharacter")
 +StructRedirects=(OldName="/Script/UHLAI.ValueOrBBKey_GameplayTag",NewName="/Script/UHLAI.UHLValueOrBBKey_GameplayTag")
++PropertyRedirects=(OldName="/Script/UHLGAS.UHLGameplayAbility.AddingToCacheInputRequiredTags",NewName="/Script/UHLGAS.UHLGameplayAbility.AddToCacheRequiredTags")
++PropertyRedirects=(OldName="/Script/UHLGAS.UHLGameplayAbility.AddingToCacheInputBlockedTags",NewName="/Script/UHLGAS.UHLGameplayAbility.AddToCacheBlockedTags")
++ClassRedirects=(OldName="/Script/UnrealHelperLibrary.ANS_SpawnAndSwitchCamera",NewName="/Script/UnrealHelperLibrary.ANS_SpawnAndSwitchPlayerCamera")

README.md

@@ -66,6 +66,12 @@ Support: `UE5.5 (main)`, `UE5.4 (branch UE5.4)`
       }
   ```
   
+  - to use specific engine version specify branch e.g. `-b UE5.4`
+
+    ```bash
+    git submodule add -b UE5.4 https://github.com/Ciberusps/unreal-helper-library.git ./Plugins/UnrealHelperLibrary
+    ```
+
   - to use specific engine version specify branch e.g. `-b UE5.4`
 
     ```bash
@@ -77,7 +83,7 @@ Support: `UE5.5 (main)`, `UE5.4 (branch UE5.4)`
 
   > [!NOTE]
   > Add `Editor Preferences -> Force Compilation on Startup` in `Config/EditorPerProjectUserSettings.ini` your team don't want to recompile plugin manually 😉
-  
+
 </details>
 
 #### From marketplace:
@@ -786,30 +792,30 @@ if you don't want to copy paste your `AttributeSets`
 
 ![image](https://github.com/user-attachments/assets/c24fd8bb-0ffe-4666-afd5-8800df650c35)
 
-**Custom thumnails** - to override thumbnail by your own, just implement `IUHECustomThumbnail` interface and define your own icon using `GetCustomThumbnailIcon()`
+**Custom thumnails** - to override thumbnail by your own, just implement `IUHLEditorCustomThumbnail` interface and define your own icon using `GetCustomThumbnailIcon()`
 
 > [!WARNING]
 > ⚠️ NOT sure that blueprints supported for now
 
 ```C++
 // UInventoryItem.h
 #if WITH_EDITOR
-#include "UHECustomThumbnail.h"
+#include "UHLEditorCustomThumbnail.h"
 #endif
 
-// IUHECustomThumbnail not available in production build
+// IUHLEditorCustomThumbnail not available in production build
 #if !WITH_EDITOR
-class IUHECustomThumbnail {};
+class IUHLEditorCustomThumbnail {};
 #endif
 
 class GAMECODE_API UInventoryItem : public UObject,
-    public IUHECustomThumbnail
+    public IUHLEditorCustomThumbnail
 {
-/** IUHECustomThumbnail **/
+/** IUHLEditorCustomThumbnail **/
 #if WITH_EDITOR
     virtual UTexture2D* GetCustomThumbnailIcon_Implementation() const override;
 #endif
-/** ~IUHECustomThumbnail **/
+/** ~IUHLEditorCustomThumbnail **/
 }
 
 ------------------------------------------------------------------

Source/UHLAI/Private/Tasks/BTT_TurnTo.cpp

@@ -75,16 +75,6 @@ void UBTT_TurnTo::PostLoad()
 	PrecisionDot = FMath::Cos(FMath::DegreesToRadians(Precision));
 }
 
-namespace
-{
-	FORCEINLINE_DEBUGGABLE FVector::FReal CalculateAngleDifferenceDot(const FVector& VectorA, const FVector& VectorB)
-	{
-		return (VectorA.IsNearlyZero() || VectorB.IsNearlyZero())
-            ? 1.f
-            : VectorA.CosineAngle2D(VectorB);
-	}
-}
-
 EBTNodeResult::Type UBTT_TurnTo::ExecuteTask(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory)
 {
 	AAIController* AIController = OwnerComp.GetAIOwner();
@@ -112,7 +102,7 @@ EBTNodeResult::Type UBTT_TurnTo::ExecuteTask(UBehaviorTreeComponent& OwnerComp,
 
 		if (ActorValue != NULL)
 		{
-			const FVector::FReal AngleDifference = CalculateAngleDifferenceDot(Pawn->GetActorForwardVector()
+			const FVector::FReal AngleDifference = TurnToStatics::CalculateAngleDifferenceDot(Pawn->GetActorForwardVector()
 				, (ActorValue->GetActorLocation() - PawnLocation));
 
 			if (AngleDifference >= PrecisionDot)
@@ -139,7 +129,7 @@ EBTNodeResult::Type UBTT_TurnTo::ExecuteTask(UBehaviorTreeComponent& OwnerComp,
 
 		if (FAISystem::IsValidLocation(KeyValue))
 		{
-			const FVector::FReal AngleDifference = CalculateAngleDifferenceDot(Pawn->GetActorForwardVector()
+			const FVector::FReal AngleDifference = TurnToStatics::CalculateAngleDifferenceDot(Pawn->GetActorForwardVector()
 				, (KeyValue - PawnLocation));
 
 			if (AngleDifference >= PrecisionDot)
@@ -205,7 +195,7 @@ void UBTT_TurnTo::TickTask(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory,
 
 		if (FocalPoint != FAISystem::InvalidLocation)
 		{
-		    float DeltaAngleRad = CalculateAngleDifferenceDot(PawnDirection, FocalPoint - AIController->GetPawn()->GetActorLocation());
+		    float DeltaAngleRad = TurnToStatics::CalculateAngleDifferenceDot(PawnDirection, FocalPoint - AIController->GetPawn()->GetActorLocation());
 		    // float DeltaAngle = FMath::RadiansToDegrees(FMath::Acos(DeltaAngleRad));
 		    float DeltaAngle = MyMemory->bActorSet
 				? UUnrealHelperLibraryBPL::RelativeAngleToActor(AICharacter, MyMemory->FocusActorSet)
@@ -248,9 +238,9 @@ void UBTT_TurnTo::TickTask(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory,
 			}
 		    else
 		    {
-		        if (IsTurnWithAnimationRequired(AICharacter))
+		        if (TurnToStatics::IsTurnWithAnimationRequired(AICharacter))
 		        {
-		            MyMemory->CurrentTurnRange = GetTurnRange(DeltaAngle, MyMemory->bCurrentTurnRangeSet, MyMemory->TurnSettings);
+		            MyMemory->CurrentTurnRange = TurnToStatics::GetTurnRange(DeltaAngle, MyMemory->bCurrentTurnRangeSet, MyMemory->TurnSettings);
 		            if (MyMemory->bCurrentTurnRangeSet && MyMemory->CurrentTurnRange.AnimMontage)
 		            {
 		                AICharacter->PlayAnimMontage(MyMemory->CurrentTurnRange.AnimMontage);
@@ -295,36 +285,6 @@ void UBTT_TurnTo::CleanUp(AAIController& AIController, uint8* NodeMemory)
 	}
 }
 
-bool UBTT_TurnTo::IsTurnWithAnimationRequired(ACharacter* Character) const
-{
-    if (!Character) return false;
-    if (Character->IsPlayingRootMotion()) return false;
-    return true;
-}
-
-FTurnRange UBTT_TurnTo::GetTurnRange(float DeltaAngle, bool& bCurrentTurnRangeSet, FTurnSettings TurnSettings_In)
-{
-    FTurnRange Result;
-    bCurrentTurnRangeSet = false;
-    for (TTuple<FString, FTurnRanges> TurnToRange : TurnSettings_In.TurnRangesGroups)
-    {
-        for (FTurnRange Range : TurnToRange.Value.TurnRanges)
-        {
-            if (Range.Range.Contains(DeltaAngle))
-            {
-                Result = Range;
-                bCurrentTurnRangeSet = true;
-                break;
-            }
-        }
-        if (bCurrentTurnRangeSet)
-        {
-            break;
-        }
-    }
-    return Result;
-}
-
 FTurnSettings UBTT_TurnTo::GetTurnSettings(AActor* Actor, bool& bCurrentTurnSettingsSet)
 {
     FTurnSettings Result;
@@ -373,7 +333,7 @@ void UBTT_TurnTo::DescribeRuntimeValues(const UBehaviorTreeComponent& OwnerComp,
 
 		if (FocalPoint != FAISystem::InvalidLocation)
 		{
-			const FVector::FReal CurrentAngleRadians = CalculateAngleDifferenceDot(PawnDirection, (FocalPoint - AIController->GetPawn()->GetActorLocation()));
+			const FVector::FReal CurrentAngleRadians = TurnToStatics::CalculateAngleDifferenceDot(PawnDirection, (FocalPoint - AIController->GetPawn()->GetActorLocation()));
 			Values.Add(FString::Printf(TEXT("Current angle: %.2f"), FMath::RadiansToDegrees(FMath::Acos(CurrentAngleRadians))));
 		}
 		else

Source/UHLAI/Public/Tasks/BTT_TurnTo.h

@@ -8,11 +8,52 @@
 #include "BehaviorTree/Services/BTService_DefaultFocus.h"
 #include "BehaviorTree/Tasks/BTTask_BlackboardBase.h"
 #include "UnrealHelperLibraryTypes.h"
+#include "GameFramework/Character.h"
 #include "BTT_TurnTo.generated.h"
 
 class AAIController;
 class ACharacter;
 
+namespace TurnToStatics
+{
+	static bool IsTurnWithAnimationRequired(ACharacter* Character)
+	{
+		if (!Character) return false;
+		if (Character->IsPlayingRootMotion()) return false;
+		return true;
+	}
+
+	static FTurnRange GetTurnRange(float DeltaAngle, bool& bCurrentTurnRangeSet, FTurnSettings TurnSettings_In)
+	{
+		FTurnRange Result;
+		bCurrentTurnRangeSet = false;
+		for (TTuple<FString, FTurnRanges> TurnToRange : TurnSettings_In.TurnRangesGroups)
+		{
+			for (FTurnRange Range : TurnToRange.Value.TurnRanges)
+			{
+				if (Range.Range.Contains(DeltaAngle))
+				{
+					Result = Range;
+					bCurrentTurnRangeSet = true;
+					break;
+				}
+			}
+			if (bCurrentTurnRangeSet)
+			{
+				break;
+			}
+		}
+		return Result;
+	}
+
+	FORCEINLINE_DEBUGGABLE FVector::FReal CalculateAngleDifferenceDot(const FVector& VectorA, const FVector& VectorB)
+	{
+		return (VectorA.IsNearlyZero() || VectorB.IsNearlyZero())
+			? 1.f
+			: VectorA.CosineAngle2D(VectorB);
+	}
+}
+
 struct FBTTurnToMemory : FBTFocusMemory
 {
     FTurnRange CurrentTurnRange;
@@ -98,7 +139,5 @@ class UHLAI_API UBTT_TurnTo : public UBTTask_BlackboardBase
     void CleanUp(AAIController& AIController, uint8* NodeMemory);
 
 private:
-    bool IsTurnWithAnimationRequired(ACharacter* Character) const;
-    FTurnRange GetTurnRange(float DeltaAngle, bool& bCurrentTurnRangeSet, FTurnSettings TurnSettings_In);
     FTurnSettings GetTurnSettings(AActor* Actor, bool& bCurrentTurnSettingsSet);
 };

Source/UHLCharacter/Private/Characters/UHLBaseCharacterWithASC.cpp

@@ -25,7 +25,18 @@ void AUHLBaseCharacterWithASC::PossessedBy(AController* NewController)
 
 	if (bInitUHLAbilitySystemOnPosses)
 	{
-	    AbilitySystemComponent->InitAbilitySystem(NewController, this);
+	    if (bDontInitOnSameControllerTwice)
+	    {
+	        if (NewController != PreviousController.Get())
+	        {
+	            AbilitySystemComponent->InitAbilitySystem(NewController, this);
+	            PreviousController = NewController;
+	        }
+	    }
+	    else
+	    {
+	        AbilitySystemComponent->InitAbilitySystem(NewController, this);
+	    }
 
 	    // Advanced setup if you want to make something after attributes set, but before abilities activated
 	    // AbilitySystemComponent->InitAbilitySystem(NewController, this, false);

Source/UHLCharacter/Private/Components/UHLCharacterMovementComponent.cpp

@@ -0,0 +1,15 @@
+// Copyright (c) 2024 NextGenium
+
+
+#include "Components/UHLCharacterMovementComponent.h"
+
+UUHLCharacterMovementComponent::UUHLCharacterMovementComponent()
+{
+	bUseControllerDesiredRotation = true;
+	bOrientRotationToMovement = false;
+}
+
+void UUHLCharacterMovementComponent::SetRotationRate(FRotator RotationRate_In)
+{
+	RotationRate = RotationRate_In;
+}

Source/UHLCharacter/Public/Characters/UHLBaseCharacterWithASC.h

@@ -26,7 +26,9 @@ class UHLCHARACTER_API AUHLBaseCharacterWithASC : public AUHLBaseCharacter,
 
 	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="UHL BaseCharacter with ASC")
 	bool bInitUHLAbilitySystemOnPosses = true;
-	
+    UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="UHL BaseCharacter with ASC")
+    bool bDontInitOnSameControllerTwice = true;
+
 	/** IAbilitySystemInterface **/
 	virtual UAbilitySystemComponent* GetAbilitySystemComponent() const override { return AbilitySystemComponent; };
 	/** ~IAbilitySystemInterface **/
@@ -37,12 +39,15 @@ class UHLCHARACTER_API AUHLBaseCharacterWithASC : public AUHLBaseCharacter,
 		return AbilitySystemComponent;
 	};
 	/** ~IUHLAbilitySystemInterface */
-	
+
 protected:
 	/** GameplayAbilities */
 	UPROPERTY(VisibleDefaultsOnly, BlueprintReadOnly, Category="UHL BaseCharacter with ASC")
 	UUHLAbilitySystemComponent* AbilitySystemComponent;
 	/** ~GameplayAbilities */
 
 	virtual void PossessedBy(AController* NewController) override;
+
+private:
+    TWeakObjectPtr<AController> PreviousController;
 };

Source/UHLCharacter/Public/Components/UHLCharacterMovementComponent.h

@@ -0,0 +1,22 @@
+// Copyright (c) 2024 NextGenium
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GameFramework/CharacterMovementComponent.h"
+#include "UHLCharacterMovementComponent.generated.h"
+
+/**
+ * 
+ */
+UCLASS(Blueprintable, BlueprintType)
+class UHLCHARACTER_API UUHLCharacterMovementComponent : public UCharacterMovementComponent
+{
+	GENERATED_BODY()
+
+public:
+	UUHLCharacterMovementComponent();
+
+	// not required?
+	void SetRotationRate(FRotator RotationRate_In);
+};

Source/UHLCharacter/UHLCharacter.Build.cs

@@ -30,7 +30,12 @@ public UHLCharacter(ReadOnlyTargetRules Target) : base(Target)
 				"GameplayAbilities",
 				"GameplayTags",
 				"GameplayTasks",
-				"EnhancedInput",  
+				"EnhancedInput",
+
+				"UnrealHelperLibrary",
+				"UHLDebugSystem",
+				"UHLAI",
+				"UHLGAS",
 			}
 			);
 
@@ -40,11 +45,6 @@ public UHLCharacter(ReadOnlyTargetRules Target) : base(Target)
 			{
 				"CoreUObject",
 				"Engine",
-
-				"UnrealHelperLibrary",
-				"UHLDebugSystem",
-				"UHLAI",
-				"UHLGAS",
 			}
 			);