MathGun

MathGun es un proyecto hecho en Unreal Engine 5 que combina mecánicas de shooter en primera persona con desafíos matemáticos interactivos. Este repositorio contiene únicamente los archivos fuente necesarios para abrir y compilar el proyecto dentro del editor.

Requisitos

• Unreal Engine 5. x (recomendado 5.3 o superior).
• Visual Studio 2022 con los componentes de desarrollo para C++ y Unreal (si vas a compilar código nativo).
• Git LFS instalado y habilitado antes de clonar, porque la mayoría de los assets (*.uasset, *.umap, etc.) se almacenan mediante LFS.

Configuración del entorno

1. Instala Git LFS y habilítalo una sola vez:

   git lfs install

2. Clona el repositorio normalmente:

   git clone https://github.com/AldoRxz/MathGun.git

3. Abre MathGunv2.uproject con Unreal Engine y deja que genere los archivos intermedios necesarios.
4. Si Unreal pregunta por compilar módulos, acepta para que construya los plugins incluidos (por ejemplo, Cargo).

Estructura principal

• Content/: Assets de juego (materiales, mapas, Blueprints, Megascans, etc.).
• Config/: Archivos .ini por defecto del proyecto.
• Plugins/: Plugins de terceros y personalizados (incluye Cargo).
• .gitignore: Configurado para omitir archivos generados automáticamente (Build/, DerivedDataCache/, Intermediate/, Saved/, ejecutables, etc.).

Flujo de trabajo

• Antes de agregar nuevos assets binarios, confirma que la extensión correspondiente esté rastreada por Git LFS (git lfs track "*.uasset", etc.).
• Usa ramas feature para cambios grandes y envía Pull Requests para revisión.
• Evita versionar carpetas generadas (paquetes, builds finales); mantenlas fuera del repositorio siguiendo las reglas del .gitignore.

Problemas conocidos

• Subidas grandes pueden fallar si Git LFS no está configurado; verifica git lfs ls-files para confirmar que los assets pesados estén apuntados por LFS.
• Al abrir el proyecto por primera vez, Unreal puede tardar en compilar shaders debido a la cantidad de materiales Megascans incluidos.