# guzmanadrianch-web/aventurausfx022026 architecture

> Architecture diagram of the GitHub repository guzmanadrianch-web/aventurausfx022026, 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/guzmanadrianch-web/aventurausfx022026
- Repository: https://github.com/guzmanadrianch-web/aventurausfx022026

## Overview

AventuraUSFX022026 is an Unreal Engine arena-shooter game. The player pawn moves and fires projectiles; enemies take damage and use health-dependent behavior strategies. On startup, the GameMode can invoke a facade that creates obstacle families, weapon and movement pickups, and an assembled enemy wave. The map emphasizes these gameplay stages and the inventory subsystem. No README is present, and several modules are indexed but unsampled, so their internal wiring is not inferred.

Main entry points: [`Source/AventuraUSFX022026/AventuraUSFX022026Pawn.cpp`](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/AventuraUSFX022026Pawn.cpp) (Player pawn), [`Source/AventuraUSFX022026/GestorJuegoFacade.cpp`](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/GestorJuegoFacade.cpp) (Game facade), [`Source/AventuraUSFX022026/AventuraUSFX022026GameMode.cpp`](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/AventuraUSFX022026GameMode.cpp) (Game mode), [`Source/AventuraUSFX022026/ConstructorOleada.cpp`](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/ConstructorOleada.cpp) (Wave builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Game runtime"]
  node_facade["Game facade"]
  node_game_mode["Game mode"]
  node_hud["HUD<br/>[CustomHUD.cpp]"]
end

subgraph group_combat["Player combat"]
  node_player["Player pawn"]
  node_weapon_states["Fire modes<br/>[EstadoDisparo.cpp]"]
  node_projectile["Projectile"]
end

subgraph group_encounters["Enemies and waves"]
  node_enemy["Enemy combat<br/>[Enemigo.cpp]"]
  node_strategies["Enemy strategies<br/>[Estrategia.cpp]"]
  node_enemy_types["Enemy variants<br/>[EnemigoJefe.cpp]"]
  node_wave_builder["Wave builder"]
  node_wave["Enemy wave<br/>[Oleada.cpp]"]
  node_wave_manager["Wave manager<br/>[GestorOleadas.cpp]"]
end

subgraph group_world["World and pickups"]
  node_obstacle_factory["Obstacle families"]
  node_obstacles["Obstacles<br/>[Muro.cpp]"]
  node_pickup_factory["Pickup factory"]
  node_pickups["Pickups"]
end

subgraph group_inventory["Inventory"]
  node_inventory["Inventory component"]
  node_inventory_item["Inventory items<br/>[InventoryActor.cpp]"]
end

node_game_mode -->|"sets default pawn"| node_player
node_game_mode -->|"sets HUD"| node_hud
node_game_mode -->|"spawns and starts"| node_facade
node_player -->|"executes fire mode"| node_weapon_states
node_player -->|"spawns"| node_projectile
node_projectile -->|"applies damage"| node_enemy
node_enemy -->|"executes strategy"| node_strategies
node_facade -->|"creates obstacle pairs"| node_obstacle_factory
node_obstacle_factory -->|"spawns variants"| node_obstacles
node_facade -->|"creates pickups"| node_pickup_factory
node_pickup_factory -->|"creates pickup types"| node_pickups
node_facade -->|"starts wave tracking"| node_wave_manager
node_facade -->|"configures and builds"| node_wave_builder
node_wave_builder -->|"constructs"| node_wave
node_wave_builder -->|"spawns configured enemies"| node_enemy_types
node_wave_manager -->|"tracks active wave"| node_wave
node_player -->|"adds collected items"| node_inventory
node_player -->|"picks up on hit"| node_inventory_item
node_player -.->|"collects generated pickups"| node_pickup_factory

click node_player "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/AventuraUSFX022026Pawn.cpp"
click node_weapon_states "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/EstadoDisparo.cpp"
click node_projectile "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/AventuraUSFX022026Projectile.cpp"
click node_enemy "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/Enemigo.cpp"
click node_strategies "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/Estrategia.cpp"
click node_enemy_types "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/EnemigoJefe.cpp"
click node_wave_builder "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/ConstructorOleada.cpp"
click node_wave "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/Oleada.cpp"
click node_wave_manager "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/GestorOleadas.cpp"
click node_facade "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/GestorJuegoFacade.cpp"
click node_game_mode "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/AventuraUSFX022026GameMode.cpp"
click node_obstacle_factory "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/FamiliaObstaculos.cpp"
click node_obstacles "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/Muro.cpp"
click node_pickup_factory "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/FabricaRecogibles.cpp"
click node_pickups "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/ObjetoRecogible.cpp"
click node_inventory "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/InventoryComponent.cpp"
click node_inventory_item "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/InventoryActor.cpp"
click node_hud "https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/CustomHUD.cpp"

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_facade,node_game_mode,node_hud toneBlue
class node_player,node_weapon_states,node_projectile toneAmber
class node_enemy,node_strategies,node_enemy_types,node_wave_builder,node_wave,node_wave_manager toneMint
class node_obstacle_factory,node_obstacles,node_pickup_factory,node_pickups toneRose
class node_inventory,node_inventory_item toneIndigo
```

## Components

### Game runtime

- [Game facade](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/GestorJuegoFacade.cpp): `Source/AventuraUSFX022026/GestorJuegoFacade.cpp`
- [Game mode](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/AventuraUSFX022026GameMode.cpp): `Source/AventuraUSFX022026/AventuraUSFX022026GameMode.cpp`
- [HUD](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/CustomHUD.cpp): `Source/AventuraUSFX022026/CustomHUD.cpp`

### Player combat

- [Player pawn](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/AventuraUSFX022026Pawn.cpp): `Source/AventuraUSFX022026/AventuraUSFX022026Pawn.cpp`
- [Fire modes](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/EstadoDisparo.cpp): `Source/AventuraUSFX022026/EstadoDisparo.cpp`
- [Projectile](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/AventuraUSFX022026Projectile.cpp): `Source/AventuraUSFX022026/AventuraUSFX022026Projectile.cpp`

### Enemies and waves

- [Enemy combat](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/Enemigo.cpp): `Source/AventuraUSFX022026/Enemigo.cpp`
- [Enemy strategies](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/Estrategia.cpp): `Source/AventuraUSFX022026/Estrategia.cpp`
- [Enemy variants](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/EnemigoJefe.cpp): `Source/AventuraUSFX022026/EnemigoJefe.cpp`
- [Wave builder](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/ConstructorOleada.cpp): `Source/AventuraUSFX022026/ConstructorOleada.cpp`
- [Enemy wave](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/Oleada.cpp): `Source/AventuraUSFX022026/Oleada.cpp`
- [Wave manager](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/GestorOleadas.cpp): `Source/AventuraUSFX022026/GestorOleadas.cpp`

### World and pickups

- [Obstacle families](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/FamiliaObstaculos.cpp): `Source/AventuraUSFX022026/FamiliaObstaculos.cpp`
- [Obstacles](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/Muro.cpp): `Source/AventuraUSFX022026/Muro.cpp`
- [Pickup factory](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/FabricaRecogibles.cpp): `Source/AventuraUSFX022026/FabricaRecogibles.cpp`
- [Pickups](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/ObjetoRecogible.cpp): `Source/AventuraUSFX022026/ObjetoRecogible.cpp`

### Inventory

- [Inventory component](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/InventoryComponent.cpp): `Source/AventuraUSFX022026/InventoryComponent.cpp`
- [Inventory items](https://github.com/guzmanadrianch-web/aventurausfx022026/blob/master/Source/AventuraUSFX022026/InventoryActor.cpp): `Source/AventuraUSFX022026/InventoryActor.cpp`

## Connections

- Game mode → Player pawn: sets default pawn (evidence: `Source/AventuraUSFX022026/AventuraUSFX022026GameMode.cpp`)
- Game mode → HUD: sets HUD (evidence: `Source/AventuraUSFX022026/AventuraUSFX022026GameMode.cpp`)
- Game mode → Game facade: spawns and starts (evidence: `Source/AventuraUSFX022026/AventuraUSFX022026GameMode.cpp`)
- Player pawn → Fire modes: executes fire mode (evidence: `Source/AventuraUSFX022026/AventuraUSFX022026Pawn.cpp`)
- Player pawn → Projectile: spawns (evidence: `Source/AventuraUSFX022026/AventuraUSFX022026Pawn.cpp`)
- Projectile → Enemy combat: applies damage (evidence: `Source/AventuraUSFX022026/AventuraUSFX022026Projectile.cpp`)
- Enemy combat → Enemy strategies: executes strategy (evidence: `Source/AventuraUSFX022026/Enemigo.cpp`)
- Game facade → Obstacle families: creates obstacle pairs (evidence: `Source/AventuraUSFX022026/GestorJuegoFacade.cpp`)
- Obstacle families → Obstacles: spawns variants (evidence: `Source/AventuraUSFX022026/FamiliaObstaculos.cpp`)
- Game facade → Pickup factory: creates pickups (evidence: `Source/AventuraUSFX022026/GestorJuegoFacade.cpp`)
- Pickup factory → Pickups: creates pickup types (evidence: `Source/AventuraUSFX022026/FabricaRecogibles.cpp`)
- Game facade → Wave manager: starts wave tracking (evidence: `Source/AventuraUSFX022026/GestorJuegoFacade.cpp`)
- Game facade → Wave builder: configures and builds (evidence: `Source/AventuraUSFX022026/GestorJuegoFacade.cpp`)
- Wave builder → Enemy wave: constructs (evidence: `Source/AventuraUSFX022026/ConstructorOleada.cpp`)
- Wave builder → Enemy variants: spawns configured enemies (evidence: `Source/AventuraUSFX022026/ConstructorOleada.cpp`)
- Wave manager → Enemy wave: tracks active wave (evidence: `Source/AventuraUSFX022026/GestorOleadas.cpp`)
- Player pawn → Inventory component: adds collected items (evidence: `Source/AventuraUSFX022026/AventuraUSFX022026Pawn.cpp`)
- Player pawn → Inventory items: picks up on hit (evidence: `Source/AventuraUSFX022026/AventuraUSFX022026Pawn.cpp`)
- Player pawn → Pickup factory: collects generated pickups
