Work on Breathing Gameplay Ability, Update Readme and plugin description

Author: colorindarkness

ALSXT.png

@@ -1,13 +1,13 @@
 {
 	"FileVersion": 3,
 	"Version": 1,
-	"VersionName": ".2",
+	"VersionName": ".5",
 	"FriendlyName": "ALSXT",
-	"Description": "An Unreal Engine 5 plugin that extends ALS-Refactored with a set of popular replicated gameplay features, to demonstrate the extendability of ALS-Refactored in a Modular, Data-Driven, UE5 Way.",
+	"Description": "An Unreal Engine 5 plugin that extends ALS-Refactored into a Modular, GAS-based, Data-oriented, Character System with the Latest UE5 Features.",
 	"Category": "Animation",
 	"CreatedBy": "Uriel Ballinas, VOIDWARE Prohibited",
-	"CreatedByURL": "https://github.com/Voidware-Prohibited",
-	"DocsURL": "https://github.com/Voidware-Prohibited/ALSXT",
+	"CreatedByURL": "https://voidwarex.com",
+	"DocsURL": "https://codeberg.org/Voidware-Prohibited/ALSXT",
 	"MarketplaceURL": "",
 	"SupportURL": "https://github.com/Voidware-Prohibited/ALSXT/discussions",
 	"EngineVersion": "5.7.0",

ALSXT.uplugin

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:33cccff7646eb7b86d635b190d81646ac52026b4dedde1eb2afa9cc867c3a4f7
-size 1547
+oid sha256:2406b730f56f7373f54acc4e19b027801d65eb0c560d725184ec68b10e9ebb85
+size 12687

Content/ALS/Data/Settings/DA_Alsxt_GeneralView_CameraSettings_Default.uasset

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:a5f67b444314c24fe7f9907def0e0c620619725f2fea104c667d051f998e4dd9
-size 916936
+oid sha256:de46374b5698747e154208918d5e2fc78e861b8ab0ee1345bb247d295f8d6e28
+size 899527

Content/ALSCamera/CDE_AlsxtCharacterPlayer.uasset

@@ -1,4 +1,7 @@
 <h1 align="center">ALSXT</h1>
+<p align="center">
+	<b>Seize the Means of Animation</b>
+</p>
 
 <p align="center">
 <img src="ALSXT.png" alt="ALSXT">
@@ -25,9 +28,9 @@
 > [!NOTE]
 > Following the acquisition of GitHub by Micro$lop, we have taken principled action and have begun primarily hosting code and content on [Codeberg](https://codeberg.org/Voidware-Prohibited/). Mirrors will still be maintained on [GitHub](https://github.com/Voidware-Prohibited/ALSXT/) and [GitLab](https://gitlab.com/Voidware-Prohibited/ALSXT/).
 
-An Unreal Engine 5 plugin that extends ALS-Refactored into a Modular, GAS-based, Data-oriented, Character System with the Latest UE5 Features. The feature-set is informed the parent project [Target Vector](https://github.com/Voidware-Prohibited/TargetVector/).
+ALSXT is a modular, GAS-based Unreal Engine 5 plugin that extends ALS-Refactored into a cutting-edge Character System. ALSXT empowers developers with AAA animation and features like Character Customization, runtime Mesh Painting, Gameplay Camera System, Combat, Impact Reactions, and advanced Firearms mechanics with Procedural Aim and Recoil, all streamlined into a rapid, data-driven workflow, ensuring stability without sacrificing flexibility. A part of the [Target Vector](https://github.com/Voidware-Prohibited/TargetVector/) framework.
 
-[Wiki](../../wiki/) - [Documentation](https://alsxt.notion.site/2be59e501e7a4bf583437d1636bc7f2f?v=ac361eb5a6a14081892ff9a68e3e7a44/) - [ALSXT Notion](https://alsxt.notion.site/2be59e501e7a4bf583437d1636bc7f2f?v=ac361eb5a6a14081892ff9a68e3e7a44/) - [Submit Pull Request](https://codeberg.org/Voidware-Prohibited/ALSXT/pulls/) - [Twitter](https://x.com/ALSXT/) - [Discord](discord://colorindarkness/)
+[📚Wiki](../../wiki/) • [📘Documentation](https://alsxt.notion.site/2be59e501e7a4bf583437d1636bc7f2f?v=ac361eb5a6a14081892ff9a68e3e7a44/) • [📑ALSXT Notion](https://alsxt.notion.site/2be59e501e7a4bf583437d1636bc7f2f?v=ac361eb5a6a14081892ff9a68e3e7a44/) • [🐤Twitter](https://x.com/ALSXT/) • [🗨️Discord](discord://colorindarkness/)
 
 # Introduction
 - Generate truly unlimited, unique and immersive Characters with extensive States, deep Character Customization, Southpaw and support for blending multiple Locomotion and Overlay Layers.
@@ -54,7 +57,7 @@ An Unreal Engine 5 plugin that extends ALS-Refactored into a Modular, GAS-based,
 
 ## Improvements
 - Alsxt Character Movement Component - Expanded Movement Featurees and GAS Integration
-- Expanded Character States - Combat Stance, Sex, Variant, Weapon Ready Position, etc
+- Expanded Character States - Orthodox/Southpaw Stances, Locmotion Variants, Readiness, Weapon Ready Position, etc
 - Expanded Footprints System - Independent foot states, Saturation, Material Transfer, Vertex Paint Support(Static Mesh only, In Progress)
 
 ## New Features
@@ -65,19 +68,19 @@ An Unreal Engine 5 plugin that extends ALS-Refactored into a Modular, GAS-based,
 	- Gameplay Camera System Director
 	- Third and First Person Camera Rigs
 - GAS Gameplay Abilities - With Cost Gameplay Effects
-	- Nearly all exiting Input Actions
+	- Nearly all existing Input Actions
 	- Movement Ability that can modify Regen Magnitudes
 	- Extended State Input Actions
 	- New Locomotion Actions: Slide, Flip, Hold Breath, Focus
-	- + More
+	- Plus more
 - GAS Gameplay Effects
 	- Staus Effects, such as Injuries, that modify Movement Speed Magnitudes
 	- Stamina Regen with Magnitude
 	- Hold Breath Regen with Magnitude
 - GAS Gameplay Attribute Sets
 	- Stamina
 	- Breath
-	- + More
+	- Plus more
 - Advanced Customizable and Paintable Master Materials for Characters and Objects
 
 ### Firearm Features
@@ -92,12 +95,12 @@ An Unreal Engine 5 plugin that extends ALS-Refactored into a Modular, GAS-based,
 ## Features In Development
 - Smart Object based Generic Interaction System
 - Contextual Animation
-- Combat System
-- Impact Reactions (Blending reaction animations with Physical Animation)
+- Combat System with Targeting
+- Impact Reactions System
 - Physical Animation
 - Character Customization
 - Paintable Mesh Components
-- Character Sound Component
+- Character Sounds
 - Vaulting
 - Idle Animation Component
 
@@ -124,14 +127,6 @@ An Unreal Engine 5 plugin that extends ALS-Refactored into a Modular, GAS-based,
      - Untested: XCode (MacOS), Jetbrains Rider, VS Code, Visual Studio (Linux)
 - clang -20 13.0.1
 
-## CI System Requirements
-Systems performing Continous Intergration Workflows will have additional requirements depending on the CI solution used.
-- Git
-- OpenCppCoverage
-- Domain Name or ngrok (For Self Hosted CI)
-- Workflow Actions services and Runners configured for Forgejo/Codeberg, GitHub or GitLab.
-- Jenkins and Java 11 (For Jenkins)
-
 ## Engine Plugins
 The following are built-in Engine plugins that are enabled in the Plugins window. Warning: some plugins may be Experimental or Beta software.
 - [Gameplay Abilities](https://dev.epicgames.com/documentation/en-us/unreal-engine/API/Plugins/GameplayAbilities/)
@@ -155,6 +150,23 @@ The following are built-in Engine plugins that are enabled in the Plugins window
 The following plugins require cloning or downloading into your projects `Plugins` folder.
 - [Advanced Locomotion System Refactored](https://github.com/Sixze/ALS-Refactored/) ![GitHub Tag](https://img.shields.io/github/v/tag/Voidware-Prohibited/ALS-Refactored)
 
+## Vertex Detection
+To enable vertex detection in packaged builds (required for line tracing, procedural mesh, or runtime vertex inspection), you must enable Allow CPU Access on each mesh. This setting ensures vertex data is not stripped during cooking, allowing CPU-based functions to read vertex buffers at runtime.
+
+For each Static Mesh:
+- Open the Static Mes in the Content Browser.
+- In the Details panel, check "Allow CPU Access".
+- Bulk Edit Meshes: For multiple meshes, select them in the Content Browser, right-click, and use Asset Actions > Bulk Edit via Property Matrix to enable this setting in bulk.
+- Rebuild/Repackage: Save the meshes and repackage the project for the changes to take effect in the build. 
+
+## CI System Requirements
+Systems performing Continous Intergration Workflows will have additional requirements depending on the CI solution used.
+- Git
+- OpenCppCoverage
+- Domain Name or ngrok (For Self Hosted CI)
+- Workflow Actions services and Runners configured for Forgejo/Codeberg, GitHub or GitLab.
+- Jenkins and Java 11 (For Jenkins)
+
 # Installation
 [Complete Installation Instructions](../..//wiki/Installation/)
 
@@ -227,12 +239,11 @@ Any git submodules are covered by their respective licenses. Content listed in t
 # Attributions
 [ATTRIBUTIONS](ATTRIBUTIONS.md)
 
-
 # Special Thanks
 
 - [Sixze](https://github.com/Sixze/)
 - [Freesound](https://freesound.org/)
 - [SketchFab](https://sketchfab.com/)
 - [Mixamo](https://www.mixamo.com/)
 - [Joseph Thigpen, Narxim](https://github.com/Narxim/) for [Narxim-GAS-Example](https://github.com/Narxim/Narxim-GAS-Example/)
-- [tranek](https://github.com/tranek/) for [GASDocumentation](https://github.com/tranek/GASDocumentation/)
+- [tranek](https://github.com/tranek/) for [GASDocumentation](https://github.com/tranek/GASDocumentation/)

README.md

@@ -1,6 +1,13 @@
 #include "AbilitySystem/GameplayAbilities/AlsxtGameplayAbilityBreathing.h"
 #include "AbilitySystemComponent.h"
+#include "ChooserFunctionLibrary.h"
+#include "AbilitySystemComponent.h"
+#include "Components/AudioComponent.h"
+#include "Kismet/GameplayStatics.h"
 #include "GameplayEffect.h"
+#include "AbilitySystem/AttributeSets/AlsxtBreathAttributeSet.h"
+#include "GameFramework/Character.h"
+#include "AbilitySystem/AttributeSets/AlsxtStaminaAttributeSet.h"
 
 UAlsxtGameplayAbilityBreathing::UAlsxtGameplayAbilityBreathing()
 {
@@ -28,6 +35,17 @@ void UAlsxtGameplayAbilityBreathing::ActivateAbility(const FGameplayAbilitySpecH
 			{
 				ActiveEffectHandle = ActorInfo->AbilitySystemComponent->ApplyGameplayEffectSpecToSelf(*SpecHandle.Data.Get());
 			}
+
+			if (GetAbilitySystemComponentFromActorInfo()) {
+				StaminaChangedDelegateHandle = GetAbilitySystemComponentFromActorInfo()->GetGameplayAttributeValueChangeDelegate(UAlsxtStaminaAttributeSet::GetCurrentStaminaAttribute()).AddUObject(this, &UAlsxtGameplayAbilityBreathing::OnStaminaChanged);
+			}
+
+			// 2. Play Looping MetaSound using Ability Task
+			ActiveBreathComponent = UGameplayStatics::SpawnSoundAttached(BreathingMetaSound, Cast<ACharacter>(GetAvatarActorFromActorInfo())->GetMesh(), VoiceSocketName);
+    
+			// 3. Setup Deactivation Listeners (Underwater/Dead/Holding Breath)
+			// GetAbilitySystemComponentFromActorInfo()->RegisterGameplayTagEvent(FGameplayTag::RequestGameplayTag("State.Dead"), EGameplayTagEventType::NewOrRemoved).AddUObject(this, &UAlsxtGameplayAbilityBreathing::OnDeactivationTagChanged, FOnAttributeChangeData);
+			// ... repeat for Underwater/HoldBreath
 		}
 	}
 }
@@ -38,6 +56,31 @@ void UAlsxtGameplayAbilityBreathing::EndAbility(const FGameplayAbilitySpecHandle
 	{
 		ActorInfo->AbilitySystemComponent->RemoveActiveGameplayEffect(ActiveEffectHandle);
 	}
+	
+	if (ActiveBreathComponent)
+	{
+		ActiveBreathComponent->Stop();
+		ActiveBreathComponent->DestroyComponent();
+	}
 
 	Super::EndAbility(Handle, ActorInfo, ActivationInfo, bReplicateEndAbility, bWasCancelled);
 }
+
+void UAlsxtGameplayAbilityBreathing::OnStaminaChanged(const FOnAttributeChangeData& Data)
+{
+	RefreshBreathingSounds(Data.NewValue);
+}
+
+void UAlsxtGameplayAbilityBreathing::RefreshBreathingSounds(float CurrentStamina)
+{
+	// 1. Use Chooser Table to determine state (0-100 stamina -> 0-1 breathIntensity)
+	// TODO: Fix EvaluateChooser call
+	// FInstancedStruct Result = UChooserFunctionLibrary::EvaluateChooser(this, BreathingChooser, FContextData(CurrentStamina));
+	// float BreathingIntensity = Result.Get<float>();
+	float BreathingIntensity = 0.3;
+
+	// 2. Pass Intensity to MetaSound
+	if (ActiveBreathComponent) {
+		ActiveBreathComponent->SetFloatParameter(FName("BreathIntensity"), BreathingIntensity);
+	}
+}

Resources/Icon128.png

@@ -2,6 +2,8 @@
 
 #include "CoreMinimal.h"
 #include "AlsxtGameplayAbilityBase.h"
+#include "Abilities/GameplayAbility.h"
+#include "Chooser.h"
 #include "AlsxtGameplayAbilityBreathing.generated.h"
 
 class UGameplayEffect;
@@ -24,5 +26,44 @@ class ALSXT_API UAlsxtGameplayAbilityBreathing : public UAlsxtGameplayAbilityBas
 	UPROPERTY(EditDefaultsOnly, Category = "Gameplay Effects")
 	TSubclassOf<UGameplayEffect> BreathingEffect;
 
+	UPROPERTY(EditDefaultsOnly, Category = "Gameplay Effects")
+	FName VoiceSocketName = "HeadSocket";
+
 	FActiveGameplayEffectHandle ActiveEffectHandle;
+
+	// Chooser Table asset to define BreathState based on Stamina
+	UPROPERTY(EditDefaultsOnly, Category = "Breathing")
+	UChooserTable* BreathingChooser; 
+
+	// MetaSound asset
+	UPROPERTY(EditDefaultsOnly, Category = "Breathing")
+	USoundBase* BreathingMetaSound;
+
+	// Tags to deactivate breath
+	UPROPERTY(EditDefaultsOnly, Category = "Breathing")
+	FGameplayTagContainer HoldingBreathTags;
+
+	// Tags to deactivate breath
+	UPROPERTY(EditDefaultsOnly, Category = "Breathing")
+	FGameplayTagContainer HoldingBreathUnderwaterTags;
+
+	// Tags to deactivate breath
+	UPROPERTY(EditDefaultsOnly, Category = "Breathing")
+	FGameplayTagContainer DeactivationTags;
+
+private:
+	void OnStaminaChanged(const FOnAttributeChangeData& Data);
+	void OnDeactivationTagChanged(const FOnAttributeChangeData& Data);
+	void RefreshBreathingSounds(float CurrentStamina);
+    
+	// Ability Task handle for the persistent sound
+	UPROPERTY()
+	class UAudioComponent* ActiveBreathComponent;
+    
+	FDelegateHandle StaminaChangedDelegateHandle;
 };
+
+inline void UAlsxtGameplayAbilityBreathing::OnDeactivationTagChanged(const FOnAttributeChangeData& Data)
+{
+	
+}