Skip to content

Commit 06aecf2

Browse files
committed
update docs
1 parent 595373a commit 06aecf2

21 files changed

+277
-121
lines changed

src/content/docs/reference/FPTagActorComponent.mdx

+1
Original file line numberDiff line numberDiff line change
@@ -18,3 +18,4 @@ __Parent Classes:__
1818

1919

2020
Helper Component to add Tags to Actor.
21+
- Adds Tags to Actor on `InitializeComponent`

src/content/docs/reference/FPTask_BlueprintBase.mdx

+7-6
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@ __FileName:__ `FPTask_BlueprintBase.h`
1414

1515

1616

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

2020
### Functions
2121

@@ -26,17 +26,18 @@ Blueprint Base Task
2626
void ReceiveSetup();
2727
```
2828
#### `ReceiveEnter`
29-
> Implement enter Task
29+
> Implement Enter Task
3030
```cpp
3131
bool ReceiveEnter();
3232
```
3333
#### `ReceiveTick`
34-
> Implement tick Task
34+
> Implement Tick from Blueprint \
35+
> !! FinishTask has to be called from ReceiveTick !!
3536
```cpp
36-
EFPTaskResult ReceiveTick(float DeltaTime);
37+
void ReceiveTick(float DeltaTime);
3738
```
3839
#### `ReceiveExit`
39-
> Implement exit Task
40+
> Implement Exit from Blueprint
4041
```cpp
4142
void ReceiveExit(EFPTaskResult TaskResult);
4243
```

src/content/docs/reference/FPTask_Delay.mdx

+5-1
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,15 @@ __Parent Classes:__
1717
[ `UFlowPilotTask` ]
1818

1919

20-
Delays Execution
20+
Simple task that adds a delay to the execution flow
2121

2222
### Properties
2323

2424
```cpp
25+
// Delay Time
26+
UPROPERTY(EditAnywhere, Category = "FlowPilot", meta=(ClampMin=0.0f, ForceUnits="s"))
27+
float DelayTime = 0.0f;
28+
2529
// Adds random deviation (TimeAmount - RndDev, TimeAmount + RndDev), Clamped (0.0f - T)
2630
UPROPERTY(EditAnywhere, Category = "FlowPilot", meta=(ClampMin=0.0f, ForceUnits="s"))
2731
float RandomDeviation = 0.0f;

src/content/docs/reference/FPTask_FlowAsset.mdx

-21
This file was deleted.
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
title: FPTask_InsideVolume.h
3+
description: Reference page for FPTask_InsideVolume.h
4+
---
5+
6+
## File Info
7+
8+
9+
__FileName:__ `FPTask_InsideVolume.h`
10+
- __Enum List:__
11+
[ [`EInsideVolumeFilterType`](#einsidevolumefiltertype) | [`EInsideVolumeComparisonOp`](#einsidevolumecomparisonop) ]
12+
- __Class List:__
13+
[ [`UFPTask_InsideVolume`](#ufptask_insidevolume) ]
14+
15+
16+
### `EInsideVolumeFilterType`
17+
18+
19+
| Value | Description |
20+
| :-- | :-- |
21+
| `ByActor` | Filter Actors by Reference |
22+
| `ByClass` | Filter Actors by Class |
23+
24+
25+
26+
### `EInsideVolumeComparisonOp`
27+
28+
29+
| Value | Description |
30+
| :-- | :-- |
31+
| `Equal` | Equal |
32+
| `NotEqual` | NotEqual |
33+
| `MoreThan` | MoreThan |
34+
| `MoreThanOrEqual` | MoreThanOrEqual |
35+
| `LessThan` | LessThan |
36+
| `LessThanOrEqual` | LessThanOrEqual |
37+
38+
39+
40+
## `UFPTask_InsideVolume`
41+
42+
43+
__Parent Classes:__
44+
[ `UFlowPilotTask` ]
45+
46+
47+
Inside Volume
48+
- Specific "Trigger Volume" class that only checks if N Actors are inside a volume.
49+
- Actors can be found by ActorReference or Class Type
50+
51+
### Properties
52+
53+
```cpp
54+
// Trigger Volume Reference
55+
UPROPERTY(EditAnywhere, Category="FlowPilot")
56+
FFlowActorReference VolumeActorReference;
57+
58+
// Actor Filter Type
59+
UPROPERTY(EditAnywhere, Category="FlowPilot")
60+
EInsideVolumeFilterType FilterActorType = EInsideVolumeFilterType::ByActor;
61+
62+
// Actor Type Reference
63+
UPROPERTY(EditAnywhere, Category="FlowPilot", meta=(EditCondition="FilterActorType==EInsideVolumeFilterType::ByActor"))
64+
FFlowActorReference ActorTypeReference;
65+
66+
// Class Type Reference
67+
UPROPERTY(EditAnywhere, Category="FlowPilot", meta=(EditCondition="FilterActorType==EInsideVolumeFilterType::ByClass"))
68+
TSoftClassPtr<AActor> ClassType;
69+
70+
// Comparison Operation for Actors Requires Inside Volume
71+
UPROPERTY(EditAnywhere, Category="FlowPilot", meta=(EditCondition="FilterActorType==EInsideVolumeFilterType::ByClass"))
72+
EInsideVolumeComparisonOp ComparisonOperation = EInsideVolumeComparisonOp::Equal;
73+
74+
// How many Actors required inside volume
75+
UPROPERTY(EditAnywhere, Category="FlowPilot", meta=(EditCondition="FilterActorType==EInsideVolumeFilterType::ByClass"))
76+
int32 RequiredActorsCount = 1;
77+
78+
```

src/content/docs/reference/FPTask_Loop.mdx

+18-1
Original file line numberDiff line numberDiff line change
@@ -17,4 +17,21 @@ __Parent Classes:__
1717
[ `UFlowPilotTask` ]
1818

1919

20-
Executes a Task in a Loop
20+
Loops a Task's execution for X amount of times, or infinite
21+
22+
### Properties
23+
24+
```cpp
25+
// Task to loop
26+
UPROPERTY(EditDefaultsOnly, Instanced, Category = "FlowPilot")
27+
TObjectPtr<UFlowPilotTask> Task;
28+
29+
// Will forever loop if True
30+
UPROPERTY(EditDefaultsOnly, Category = "FlowPilot")
31+
uint8 bIsInfinite : 1;
32+
33+
// Number of times to repeat the same task
34+
UPROPERTY(EditDefaultsOnly, Category = "FlowPilot", meta=(ClampMin=1, EditCondition="!bIsInfinite"))
35+
int32 Loops = 3;
36+
37+
```

src/content/docs/reference/FPTask_Parallel.mdx

+2-1
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,8 @@ Parallel Task
3838
### Properties
3939

4040
```cpp
41-
// This defines what makes this Task succeed to continue flow.
41+
// Desired Completion Type allows changing the Parallel Task Behavior
42+
// See EFlowParallelCompletetionType enum
4243
UPROPERTY(EditDefaultsOnly, Category="FlowPilot")
4344
EFlowParallelCompletionType DesiredCompletionType = EFlowParallelCompletionType::AllSucceed;
4445

src/content/docs/reference/FPTask_PlayAnimation.mdx

+7-7
Original file line numberDiff line numberDiff line change
@@ -19,26 +19,26 @@ __Parent Classes:__
1919
[ `UFlowPilotTask` ]
2020

2121

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

2626
### Properties
2727

2828
```cpp
29-
// Actors this animation asset will be played on
29+
// Pawns to play animations on
3030
UPROPERTY(EditAnywhere, Category="FlowPilot")
3131
FFlowActorReference ActorsToPlayAnimationOn;
3232

33-
// Animation Asset to use
33+
// Animation Asset to play
3434
UPROPERTY(EditAnywhere, Category="FlowPilot")
3535
TSoftObjectPtr<UAnimationAsset> AnimationAsset;
3636

37-
// Loop animation if true
37+
// if true, will loop animations
3838
UPROPERTY(EditAnywhere, Category="FlowPilot")
3939
uint8 bLooping : 1;
4040

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

src/content/docs/reference/FPTask_PlaySound.mdx

+3-3
Original file line numberDiff line numberDiff line change
@@ -22,15 +22,15 @@ Plays SoundCues or SoundWaves
2222
### Properties
2323

2424
```cpp
25-
// Where to play sound from.
25+
// Actor Reference to use as source location
2626
UPROPERTY(EditAnywhere, Category = "FlowPilot")
2727
FFlowActorReference ActorReference;
2828

29-
// SoundCue to Play
29+
// Sound Cue to play
3030
UPROPERTY(EditAnywhere, Category="FlowPilot")
3131
TObjectPtr<USoundCue> SoundToPlay;
3232

33-
// SoundWave to Play
33+
// Sound Wave to play
3434
UPROPERTY(EditAnywhere, Category="FlowPilot")
3535
TObjectPtr<USoundWave> SoundWaveToPlay;
3636

src/content/docs/reference/FPTask_PlaySound2D.mdx

+7-7
Original file line numberDiff line numberDiff line change
@@ -22,15 +22,15 @@ Play 2D Sounds
2222
### Properties
2323

2424
```cpp
25-
// SoundCue to play
25+
// Sound Cue to Play
2626
UPROPERTY(EditAnywhere, Category="FlowPilot")
2727
TObjectPtr<USoundCue> SoundToPlay;
2828

29-
// SoundWave to play
29+
// Sound Wave to Play
3030
UPROPERTY(EditAnywhere, Category="FlowPilot")
3131
TObjectPtr<USoundWave> SoundWaveToPlay;
3232

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

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

45-
// Play Start time
45+
// Play Start Time
4646
UPROPERTY(EditAnywhere, Category="FlowPilot", AdvancedDisplay)
4747
float StartTime = 0.0f;
4848

49-
// Concurrency Settings
49+
// Sound Concurrency Settings
5050
UPROPERTY(EditAnywhere, Category="FlowPilot", AdvancedDisplay)
5151
USoundConcurrency* ConcurrencySettings = nullptr;
5252

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

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

src/content/docs/reference/FPTask_PossessPawn.mdx

+4-11
Original file line numberDiff line numberDiff line change
@@ -17,29 +17,22 @@ __Parent Classes:__
1717
[ `UFlowPilotTask` ]
1818

1919

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

2424
### Properties
2525

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

33-
// If true, the Player will posses the Pawn
31+
// Player Possesses only 1 Pawn
3432
UPROPERTY(EditAnywhere, Category="FlowPilot")
3533
bool bPossessByPlayer = false;
3634

37-
// Player Controller Index, in single player games this is usually 0.
38-
// for more complex cases, this could be parameterized
39-
UPROPERTY(EditAnywhere, Category="FlowPilot", meta=(EditCondition="bPossessByPlayer", EditConditionHides))
40-
int32 PlayerIndex = 0;
41-
42-
// AI Controller class to posses Pawn with
35+
// AI Controller Class to Posses Pawns with.
4336
UPROPERTY(EditAnywhere, Category="FlowPilot", meta=(EditCondition="!bPossessByPlayer", EditConditionHides))
4437
TSubclassOf<AController> ControllerClass;
4538

src/content/docs/reference/FPTask_Selector.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ __FileName:__ `FPTask_Selector.h`
1414

1515

1616
__Parent Classes:__
17-
[ `UFPTaskRunner` ]
17+
[ `UFPTask_Sequence` ]
1818

1919

2020
Selector Task

src/content/docs/reference/FPTask_Sequence.mdx

+1-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ __FileName:__ `FPTask_Sequence.h`
1414

1515

1616
__Parent Classes:__
17-
[ `UFPTaskRunner` ]
17+
[ `UFlowPilotParent` ]
1818

1919

2020
Sequence Task

0 commit comments

Comments
 (0)