Introducción y Arquitectura del Sistema

</aside>

El Multiplayer Shooter System (MSS) es un framework modular basado en componentes (Component-Based Architecture) diseñado para implementar mecánicas de disparo replicadas en Unreal Engine 5.

El sistema reside en Content/DMD/Blueprints/Components/Shooter_System/. Su diseño centraliza toda la lógica de combate en un único componente, desacoplando las mecánicas del Pawn. Esto permite su implementación en Personajes, Vehículos o Torretas mediante composición.

"Un diagrama de flujo donde el BPC_Shooter_System está en el centro. Recibe inputs del Player Controller. Controla el BP_Weapon_Master y el sistema se comunica con el Animation Blueprint mediante Interfaces."

1. Núcleo: BPC_Shooter_System

</aside>

El corazón del sistema es el Actor Component 🟦 BPC_Shooter_System. Este componente actúa como gestor principal de estado y no requiere herencia en la clase del personaje.

Sus responsabilidades son:

Gestión de Inputs: Procesa las acciones del contexto 🟦 IMC_Shooter (Disparo, Recarga, Cambio de Arma).
Máquina de Estados: Administra modos como Throwing (Granadas), Reloading o WallBlocked.
Validación de Red: Ejecuta lógica autoritativa en el servidor para validar munición e impactos. Replica los efectos visuales (Cosmetics) a los clientes.

2. Polimorfismo de Actores

</aside>

El sistema adapta su comportamiento automáticamente según la variable 🟩 Actor_Type (basada en el enumerador 🟨 ENU_Actor_Type). Esto divide la arquitectura en dos flujos:

<aside>

A. Characters (Humanoides)

Habilita la lógica avanzada de infantería:

Light Weapons (LW): Armas interactuables con física.
Sistema de Holsters: Usa actores hijos 🟦 BP_Holster_Socket para visualizar armas en el cuerpo.
Wall Detection: Trazado esférico que detecta colisiones con el entorno y levanta el arma proceduralmente.
Animación: Integración mediante Linked Anim Layer 🟦 ABP_Overlay_Shooter. </aside>

<aside>

B. Vehicles / Pawns (Maquinaria)

Habilita la lógica simplificada para unidades mecánicas:

Heavy Weapons (HW): Armas fijas integradas en el chasis.
Inventario Estático: Sin lógica de recogida (Pickup) ni animaciones humanas. </aside>

3. Arquitectura de Armas

</aside>

El arsenal utiliza una jerarquía de clases derivada de 🟦 BP_Weapon_Master, evitando Data Tables para la lógica.

<aside>

A. Light Weapons (LW)

Hijas de 🟦 BP_LW_Master. Diseñadas para personajes.

Físicas Optimizadas: Simulan física real solo cuando están en el mundo (sin Owner). Al tocar el suelo, desactivan la simulación (Sleep) para ahorrar rendimiento.
Interaction: Lógica para ser recogidas y equipadas en el socket 🟩 Weapon_TPS (mano derecha).
IK Hand Left: Usan un billboard visual 🟩 IK_Hand_Left dentro del Blueprint para definir la posición de la mano izquierda sin ajustar coordenadas numéricas. </aside>

<aside>

B. Heavy Weapons (HW)

Hijas de 🟦 BP_HW_Master. Diseñadas para vehículos.

Funcionan como componentes fijos sin inventario físico ni colisión con paredes. </aside>

4. Balística y Feedback

</aside>

<aside>

El sistema de disparo gestiona dos tipos de proyectiles:

Físicos: Actores derivados de 🟦 BP_Projectile_Master (canal de colisión Projectile). Gestionan su propio daño y VFX de impacto.
HitScan: Trazado inmediato para láseres (canal de colisión Laser). </aside>

<aside>

Interfaz de Usuario (UI)

El feedback visual se centraliza en el widget 🟦 WBP_Shooter_Hud.

Gestiona el Crosshair Dinámico (🟦 WBP_Crosshair_Master), cuya apertura se calcula mediante un alpha de dispersión (Current_Dispersion) basado en el movimiento y disparo. </aside>

5. Integración Modular

</aside>

El MSS se comunica con sistemas externos mediante interfaces para evitar dependencias directas:

Locomoción: A través de 🟨 BPI_Locomotion, recibe el estado de movimiento (del MLS o GASP) para adaptar las capas de animación del tren superior.
Objetivos: A través de 🟨 BPI_Target, consulta la identidad del actor (Aliado/Enemigo) para gestionar el fuego amigo y el color del Crosshair.