Skip to content

Commit

Permalink
update docs
Browse files Browse the repository at this point in the history
  • Loading branch information
Mikea15 committed Sep 8, 2024
1 parent 0c5c2b7 commit 1adc232
Show file tree
Hide file tree
Showing 10 changed files with 52 additions and 47 deletions.
11 changes: 6 additions & 5 deletions src/content/docs/reference/FPTask_BlueprintBase.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +14,8 @@ __FileName:__ `FPTask_BlueprintBase.h`



Blueprint Base Task
- Inherit from Blueprints to have custom BP Tasks.
Create Blueprint Tasks using this class as base.
- If Tick is not implemented, will instantly succeed on first tick.

### Functions

Expand All @@ -26,17 +26,18 @@ Blueprint Base Task
void ReceiveSetup();
```
#### `ReceiveEnter`
> Implement enter Task
> Implement Enter Task
```cpp
bool ReceiveEnter();
```
#### `ReceiveTick`
> Implement tick Task
> Implement Tick Task \
> auto succeeds if not implemented in Blueprint Task
```cpp
EFPTaskResult ReceiveTick(float DeltaTime);
```
#### `ReceiveExit`
> Implement exit Task
> Implement Exit Task
```cpp
void ReceiveExit(EFPTaskResult TaskResult);
```
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/reference/FPTask_Delay.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ __Parent Classes:__
[ `UFlowPilotTask` ]


Delays Execution
Simple task that adds a delay to the execution flow

### Properties

Expand Down
19 changes: 18 additions & 1 deletion src/content/docs/reference/FPTask_Loop.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,4 +17,21 @@ __Parent Classes:__
[ `UFlowPilotTask` ]


Executes a Task in a Loop
Loops a Task's execution for X amount of times, or infinite

### Properties

```cpp
// Task to loop
UPROPERTY(EditDefaultsOnly, Instanced, Category = "FlowPilot")
TObjectPtr<UFlowPilotTask> Task;

// Will forever loop if True
UPROPERTY(EditDefaultsOnly, Category = "FlowPilot")
uint8 bIsInfinite : 1;

// Number of times to repeat the same task
UPROPERTY(EditDefaultsOnly, Category = "FlowPilot", meta=(ClampMin=1, EditCondition="!bIsInfinite"))
int32 Loops = 3;

```
14 changes: 7 additions & 7 deletions src/content/docs/reference/FPTask_PlayAnimation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,26 +19,26 @@ __Parent Classes:__
[ `UFlowPilotTask` ]


Play Animation
- Can Play an animation on many Pawns
- Can wait for animations to finish to continue
Task that plays an animation
- Will play the animation to one or multiple Pawns found via FlowActorReference
- Option to wait for animations to complete before succeeding

### Properties

```cpp
// Actors this animation asset will be played on
// Pawns to play animations on
UPROPERTY(EditAnywhere, Category="FlowPilot")
FFlowActorReference ActorsToPlayAnimationOn;

// Animation Asset to use
// Animation Asset to play
UPROPERTY(EditAnywhere, Category="FlowPilot")
TSoftObjectPtr<UAnimationAsset> AnimationAsset;

// Loop animation if true
// if true, will loop animations
UPROPERTY(EditAnywhere, Category="FlowPilot")
uint8 bLooping : 1;

// Waits for animation to complete to continue execution
// if true, will wait for animation to finish before succeeding task
UPROPERTY(EditAnywhere, Category="FlowPilot")
uint8 bWaitForAnimationEnd : 1;

Expand Down
6 changes: 3 additions & 3 deletions src/content/docs/reference/FPTask_PlaySound.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,15 +22,15 @@ Plays SoundCues or SoundWaves
### Properties

```cpp
// Where to play sound from.
// Actor Reference to use as source location
UPROPERTY(EditAnywhere, Category = "FlowPilot")
FFlowActorReference ActorReference;

// SoundCue to Play
// Sound Cue to play
UPROPERTY(EditAnywhere, Category="FlowPilot")
TObjectPtr<USoundCue> SoundToPlay;

// SoundWave to Play
// Sound Wave to play
UPROPERTY(EditAnywhere, Category="FlowPilot")
TObjectPtr<USoundWave> SoundWaveToPlay;

Expand Down
14 changes: 7 additions & 7 deletions src/content/docs/reference/FPTask_PlaySound2D.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,15 +22,15 @@ Play 2D Sounds
### Properties

```cpp
// SoundCue to play
// Sound Cue to Play
UPROPERTY(EditAnywhere, Category="FlowPilot")
TObjectPtr<USoundCue> SoundToPlay;

// SoundWave to play
// Sound Wave to Play
UPROPERTY(EditAnywhere, Category="FlowPilot")
TObjectPtr<USoundWave> SoundWaveToPlay;

// Is UI Sound
// if true, will play as UI sound
UPROPERTY(EditAnywhere, Category="FlowPilot")
uint8 bIsUISound : 1;

Expand All @@ -42,19 +42,19 @@ float VolumeMultiplier = 1.0f;
UPROPERTY(EditAnywhere, Category="FlowPilot", AdvancedDisplay)
float PitchMultiplier = 1.0f;

// Play Start time
// Play Start Time
UPROPERTY(EditAnywhere, Category="FlowPilot", AdvancedDisplay)
float StartTime = 0.0f;

// Concurrency Settings
// Sound Concurrency Settings
UPROPERTY(EditAnywhere, Category="FlowPilot", AdvancedDisplay)
USoundConcurrency* ConcurrencySettings = nullptr;

// If the Sound persists across level changes
// if True, sound will persist across level changes
UPROPERTY(EditAnywhere, Category="FlowPilot", AdvancedDisplay)
bool bPersistAcrossLevels = false;

// Automatically destroy sound when finished playing
// if true, sound actor will auto destroy once finished playing
UPROPERTY(EditAnywhere, Category="FlowPilot", AdvancedDisplay)
bool bAutoDestroy = true;

Expand Down
15 changes: 4 additions & 11 deletions src/content/docs/reference/FPTask_PossessPawn.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,29 +17,22 @@ __Parent Classes:__
[ `UFlowPilotTask` ]


Posses Pawn:
Possess Pawn
- Spawns a Controller and Possesses a Pawn
- Can Possess multiple Pawns at the same time using a shared GameplayTag 🏷️
- Can Possess multiple Pawns at the same time

### Properties

```cpp
// Pawns to Possess
// if possessed by Player, will only search for 1 Pawn.
// if possessed by AI Controller, will search for multiple Pawns.
UPROPERTY(EditAnywhere, Category="FlowPilot")
FFlowActorReference PawnsToPossess;

// If true, the Player will posses the Pawn
// Player Possesses only 1 Pawn
UPROPERTY(EditAnywhere, Category="FlowPilot")
bool bPossessByPlayer = false;

// Player Controller Index, in single player games this is usually 0.
// for more complex cases, this could be parameterized
UPROPERTY(EditAnywhere, Category="FlowPilot", meta=(EditCondition="bPossessByPlayer", EditConditionHides))
int32 PlayerIndex = 0;

// AI Controller class to posses Pawn with
// AI Controller Class to Posses Pawns with.
UPROPERTY(EditAnywhere, Category="FlowPilot", meta=(EditCondition="!bPossessByPlayer", EditConditionHides))
TSubclassOf<AController> ControllerClass;

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/reference/FPTask_SpawnClass.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Spawns a Class
### Properties

```cpp
// Spawn Lifetime dictates when we Destroy this Actor or leave it alive forever
// SpawnLifetime dictates when we Destroy this Actor, (or leave it alive forever)
UPROPERTY(EditAnywhere, Category = "FlowPilot")
EFlowActorSpawnLifetime ActorSpawnLifetime = EFlowActorSpawnLifetime::Persistent;

Expand Down
4 changes: 0 additions & 4 deletions src/content/docs/reference/FPTask_TriggerDistance.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -54,10 +54,6 @@ FFlowActorReference FirstActorReference;
UPROPERTY(EditAnywhere, Category = "FlowPilot")
ETriggerDistanceOp Operation = ETriggerDistanceOp::LessThan;

// Distance Method
UPROPERTY(EditAnywhere, Category = "FlowPilot")
EDistanceMethod Method = EDistanceMethod::Distance3D;

// Threshold to check distance against
UPROPERTY(EditAnywhere, Category = "FlowPilot", meta=(ClampMin=0.0f))
float ThresholdDistance;
Expand Down
12 changes: 5 additions & 7 deletions src/content/docs/reference/FPTask_TriggerVolume.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@ __FileName:__ `FPTask_TriggerVolume.h`

| Value | Description |
| :-- | :-- |
| `OnEnter` | Triggers when Entering Volume |
| `OnExit` | Triggers when Exiting Volume |
| `OnEnter` | OnEnter |
| `OnExit` | OnExit |



Expand All @@ -29,18 +29,16 @@ __Parent Classes:__
[ `UFlowPilotTask` ]


Trigger by Volume Task
- Allows choosing to Trigger (succeed task) on Entry or Exit of a volume
- Allows to wait on multiple Pawns
Trigger by Volume

### Properties

```cpp
// Trigger Event to Listen to
// Trigger to Listen to
UPROPERTY(EditAnywhere, Category = "FlowPilot")
ETriggerVolumeEvent TriggerEvent;

// Volume Reference Actor. Should be single actor
// Volume Reference Actor
UPROPERTY(EditAnywhere, Category = "FlowPilot")
FFlowActorReference VolumeReference;

Expand Down

0 comments on commit 1adc232

Please sign in to comment.