# coffeevampir3/unreal-3rd-person-parkour architecture

> Architecture diagram of the GitHub repository coffeevampir3/unreal-3rd-person-parkour, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/coffeevampir3/unreal-3rd-person-parkour
- Repository: https://github.com/coffeevampir3/unreal-3rd-person-parkour

## Overview

This is an Unreal Engine game-animation sample rewritten in C++, with runtime code for player input, movement, and parkour traversal. The main flow is player input into the controller and parkour component, which checks traversable geometry, selects and warps a traversal animation, then advances its coroutine state machine. The repository also contains animation and character assets. Relationships involving unsampled asset wiring are not asserted; the graph reflects the shown C++ and file tree.

Main entry points: [`Source/GameAnimationSample/Private/Parkour/ParkourComponent.cpp`](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/Parkour/ParkourComponent.cpp) (Parkour Component), [`Source/GameAnimationSample/Private/Player/EnhancedPlayerController.cpp`](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/Player/EnhancedPlayerController.cpp) (Player Controller), [`Source/GameAnimationSample/Private/CoroStateMachine/CoroStateMachine.cpp`](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/CoroStateMachine/CoroStateMachine.cpp) (Coroutine State Machine), [`Source/GameAnimationSample/Public/Input/EnhancedPlayerInputComponent.h`](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Public/Input/EnhancedPlayerInputComponent.h) (Enhanced Input)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Player Input"]
  node_controller["Player Controller"]
  node_input_component["Enhanced Input"]
  node_input_config["Input Configuration"]
end

subgraph group_traversal["Traversal Runtime"]
  node_parkour["Parkour Component"]
  node_traversable["Traversable Actor"]
  node_state_machine["Coroutine State Machine"]
  node_coro_state["Coroutine State<br/>[CoroState.h]"]
  node_coro_task["Coroutine Task<br/>[CoroTask.h]"]
end

subgraph group_content["Game Content"]
  node_traversal_assets["Traversal Animations"]
  node_motion_matching["Motion Matching Data"]
  node_character_assets["Character Assets"]
end

node_player(("Player"))

node_player -->|"provides input"| node_controller
node_controller -->|"binds actions"| node_input_component
node_input_component -->|"reads mappings"| node_input_config
node_controller -->|"binds configured actions"| node_input_config
node_parkour -->|"queries ledges"| node_traversable
node_parkour -->|"runs state machine"| node_state_machine
node_state_machine -->|"manages states"| node_coro_state
node_state_machine -->|"awaits tasks"| node_coro_task
node_parkour -.->|"selects animation"| node_traversal_assets
node_parkour -.->|"may use animation data"| node_motion_matching

click node_controller "https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/Player/EnhancedPlayerController.cpp"
click node_input_component "https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Public/Input/EnhancedPlayerInputComponent.h"
click node_input_config "https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Public/Input/GameInputConfiguration.h"
click node_parkour "https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/Parkour/ParkourComponent.cpp"
click node_traversable "https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/Traversables/TraversableActor.cpp"
click node_state_machine "https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/CoroStateMachine/CoroStateMachine.cpp"
click node_coro_state "https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Public/CoroStateMachine/CoroState.h"
click node_coro_task "https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Public/CoroStateMachine/CoroTask.h"
click node_traversal_assets "https://github.com/coffeevampir3/unreal-3rd-person-parkour/tree/main/Content/Characters/UEFN_Mannequin/Animations/Traversal"
click node_motion_matching "https://github.com/coffeevampir3/unreal-3rd-person-parkour/tree/main/Content/Characters/UEFN_Mannequin/Animations/MotionMatchingData"
click node_character_assets "https://github.com/coffeevampir3/unreal-3rd-person-parkour/tree/main/Content/Characters"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_controller,node_input_component,node_input_config toneBlue
class node_parkour,node_traversable,node_state_machine,node_coro_state,node_coro_task toneAmber
class node_traversal_assets,node_motion_matching,node_character_assets toneMint
class node_player toneIndigo
```

## Components

### Player Input

- [Player Controller](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/Player/EnhancedPlayerController.cpp): `Source/GameAnimationSample/Private/Player/EnhancedPlayerController.cpp`
- [Enhanced Input](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Public/Input/EnhancedPlayerInputComponent.h): `Source/GameAnimationSample/Public/Input/EnhancedPlayerInputComponent.h`
- [Input Configuration](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Public/Input/GameInputConfiguration.h): `Source/GameAnimationSample/Public/Input/GameInputConfiguration.h`

### Traversal Runtime

- [Parkour Component](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/Parkour/ParkourComponent.cpp): `Source/GameAnimationSample/Private/Parkour/ParkourComponent.cpp`
- [Traversable Actor](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/Traversables/TraversableActor.cpp): `Source/GameAnimationSample/Private/Traversables/TraversableActor.cpp`
- [Coroutine State Machine](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Private/CoroStateMachine/CoroStateMachine.cpp): `Source/GameAnimationSample/Private/CoroStateMachine/CoroStateMachine.cpp`
- [Coroutine State](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Public/CoroStateMachine/CoroState.h): `Source/GameAnimationSample/Public/CoroStateMachine/CoroState.h`
- [Coroutine Task](https://github.com/coffeevampir3/unreal-3rd-person-parkour/blob/main/Source/GameAnimationSample/Public/CoroStateMachine/CoroTask.h): `Source/GameAnimationSample/Public/CoroStateMachine/CoroTask.h`

### Game Content

- [Traversal Animations](https://github.com/coffeevampir3/unreal-3rd-person-parkour/tree/main/Content/Characters/UEFN_Mannequin/Animations/Traversal): `Content/Characters/UEFN_Mannequin/Animations/Traversal`
- [Motion Matching Data](https://github.com/coffeevampir3/unreal-3rd-person-parkour/tree/main/Content/Characters/UEFN_Mannequin/Animations/MotionMatchingData): `Content/Characters/UEFN_Mannequin/Animations/MotionMatchingData`
- [Character Assets](https://github.com/coffeevampir3/unreal-3rd-person-parkour/tree/main/Content/Characters): `Content/Characters`

### Other components

- **Player**

## Connections

- Player → Player Controller: provides input (evidence: `Source/GameAnimationSample/Private/Player/EnhancedPlayerController.cpp`)
- Player Controller → Enhanced Input: binds actions (evidence: `Source/GameAnimationSample/Private/Player/EnhancedPlayerController.cpp`)
- Enhanced Input → Input Configuration: reads mappings (evidence: `Source/GameAnimationSample/Public/Input/EnhancedPlayerInputComponent.h`)
- Player Controller → Input Configuration: binds configured actions (evidence: `Source/GameAnimationSample/Private/Player/EnhancedPlayerController.cpp`)
- Parkour Component → Traversable Actor: queries ledges (evidence: `Source/GameAnimationSample/Private/Parkour/ParkourComponent.cpp`)
- Parkour Component → Coroutine State Machine: runs state machine (evidence: `Source/GameAnimationSample/Private/Parkour/ParkourComponent.cpp`)
- Coroutine State Machine → Coroutine State: manages states
- Coroutine State Machine → Coroutine Task: awaits tasks
- Parkour Component → Traversal Animations: selects animation
- Parkour Component → Motion Matching Data: may use animation data
