Cómo utilizar GitHub y Git con Unreal Engine 5

▶

te guiará paso a paso en el proceso de publicar y versionar tu proyecto de Unreal Engine usando Git y GitHub. Utiliza los marcadores de tiempo si deseas saltar directamente a los comandos.

1. ❓ ¿Por Qué los Desarrolladores de Videojuegos Deben Usar Git?

Como desarrollador de software, el uso de Git me parece fundamental en la programación moderna. Me sorprende que muchos desarrolladores de videojuegos (sobre todo indies) parezcan evitar o no priorizar el uso de Git y GitHub, cuando ofrece beneficios cruciales, especialmente con motores como Unreal o Unity.

• Protección del Proyecto (Backup)   
  • Git crea un versionamiento completo del código cada vez que decides guardar un commit.   
  • Si un cambio o una actualización hace que el proyecto de Unreal deje de abrir (como le pasó al desarrollador Knu), puedes ejecutar git checkout [commit_hash] y volver instantáneamente a una versión funcional anterior, perdiendo solo el trabajo del último cambio.
• Bitácora y Seguimiento
  • Tienes un registro histórico (git log) de todos los cambios, permitiendo ver la evolución del proyecto.    Si eliminaste código por error o necesitas revisar cómo se implementó una funcionalidad hace meses, lo puedes recuperar fácilmente.
• Colaboración   
  • Permite que múltiples desarrolladores trabajen simultáneamente en el mismo proyecto sin interferencias masivas.   
  • Esencial para cualquier equipo.
• Sincronización (GitHub)   
  • GitHub o Bitbucket es un repositorio remoto (en la nube).   
  • Si tu disco duro falla o pierdes tu computadora, tu trabajo estará siempre a salvo en Internet, permitiéndote sincronizarlo en cualquier otro equipo.
• Trabajo en Múltiples Equipos  
  • Puedes sincronizar tu trabajo sin esfuerzo entre una PC de escritorio, una laptop, o una Mac. 
  • Si haces diseño de niveles en tu laptop y luego codificas los Blueprints en tu PC, usas un simple git pull y git push.

2. ️ Instalación y Configuración de Git y GitHub

A. Instalar Git

• En Mac: Git ya viene preinstalado. Si necesitas actualizarlo, puedes usar homebrew (brew install git).
• En Windows: Descarga el instalador desde la web oficial. Durante la instalación, asegúrate de que la opción para agregar Git al PATH esté marcada.
• Verificación: Abre tu terminal (o cmd) y ejecuta git. Si ves la lista de comandos, la instalación fue exitosa.

B. Crear un Repositorio en GitHub

GitHub (o cualquier repositorio remoto) es donde guardaremos nuestro código en la nube.

1. Ve a GitHub, crea una cuenta si no tienes.
2. Haz clic en "New Repository" (+).
3. Asigna un nombre a tu proyecto.
4. Selecciona "Private" si no deseas que tu código sea accesible públicamente (ideal para juegos que planeas vender).
5. Haz clic en "Create Repository". La siguiente pantalla te dará los comandos necesarios para vincular tu proyecto local con este repositorio.

3. ️ Preparar y Sincronizar tu Proyecto de Unreal

A. Habilitar Git en Unreal Engine

• Abre tu proyecto de Unreal Engine.
• Ve a "Version Control" (Control de Versión).
• Selecciona "Git" como proveedor.
• Unreal Engine debería inicializar el repositorio Git por ti (ejecutando git init internamente). Si te da un error, asegúrate de que Git esté instalado correctamente.
• Acepta la configuración (botón azul).

B. Primera Publicación (Vincular y Subir el Proyecto)

Debes ejecutar los comandos en la carpeta raíz de tu proyecto de Unreal (donde se encuentran las carpetas Content y Config).

Vincular el Repositorio Remoto: Copia el comando que te proporcionó GitHub:

git remote add origin [URL_DEL_REPOSITORIO]

Preparar Archivos (Staging): Rastrea todos los archivos en la carpeta raíz para el commit.

git add .

Crear el Commit (Versión Local): Guarda los cambios con un mensaje descriptivo.

git commit -m “Initial commit of Unreal Project”

Sincronizar con GitHub (Push): Envía la versión local al repositorio remoto.

git push -u origin main

¡Advertencia! El primer git push puede tardar mucho ya que los proyectos de Unreal son pesados (varios GB). Se recomienda hacer esto inmediatamente después de crear el proyecto para subir menos archivos. Unreal te pedirá autenticarte con tu cuenta de GitHub en una ventana emergente.

Clonar el Proyecto en un Nuevo PC (Método Alternativo)

Si necesitas obtener el proyecto en otro equipo:

Forma Rápida (Recomendada): En la nueva ubicación (ej: Documentos), usa el comando git clone seguido de la URL del repositorio:

git clone [URL_DEL_REPOSITORIO]

Forma Lenta (Si falla el clone): Debido al gran tamaño de los proyectos de Unreal y posibles interrupciones de red, el git clone puede fallar. Si esto sucede, simplemente copia la carpeta completa del proyecto original (que ya incluye la carpeta .git con todo el historial) a la nueva ubicación usando un disco duro o pendrive. Una vez copiado, usa git pull y git push normalmente.

Resumen

Beneficio Adicional: Sincronización Multi-Equipo

Y un tercero que viene de gratis es que, si eres como yo que trabaja en múltiples computadoras (yo en este caso utilizo tres), puedes sincronizarlas fácilmente en cualquiera de ellas tres sin ningún problema.

Primeros Pasos: Proyecto en Unreal Creado

Entonces, ahí tienes las ventajas. Lo siguiente es qué tenemos que hacer para utilizar esto. Obviamente, tienes que tener creado tu proyecto en Unreal. Ya eso ya lo doy por hecho. Ya estamos en el segundo punto.

Paso 1: Crear una Cuenta en GitHub

Lo siguiente es venir aquí a esta página llamada GitHub, que es donde va a estar almacenado, como quien dice, de manera remota tu proyecto. Es completamente seguro, no te preocupes por eso. Hay muchas páginas similares a esta, como GitLab, pero esta es la más utilizada, la que te recomendaría, aunque eres libre de ver el resto de las opciones. Aquí es lo normal: aquí ya yo tengo una cuenta, pero tú te registras, te autenticas o te creas una cuenta, y poco más que decir. Luego, crearás el repositorio para tu proyecto. Puedes colocarlo en privado si así lo deseas.

Paso 2: Verificar o Instalar Git en tu Mac

Cómo instalar Git: si estás en Mac, puede que ya lo tengas ahí. Simplemente tienes que escribir git en la terminal y poco más que decir. De igual manera, ahorita vamos a ver algunos comandos, pero otra vez, la parte de la configuración ya la doy por hecha.

Inicializar proyecto en unreal

En este caso sí te voy a mostrar un videíto para que quede un poquito más claro entonces ya yo aquí creé el proyecto y toda la cuestión.

Lo primero que tenemos que hacer y lo único que tenemos que hacer aquí, en la esquina donde dice revisión de control y agregas aquí el de git, agregas el repositorio y eso es todo.

Siguiente punto, cierras el proyecto en Unreal y haces un cd hasta la ubicación del proyecto.

Y los comandos necesarios

get status 

Para ver los cambios realizados.

git add.
git commit -m “”

Para agregar los cambios

git push

Para sincronizar los cambios, recuerda agregar el remoto como se muestra el vídeo para que puedas agregar los cambios al repo de GitHub.

Importante: Los archivos no tienen que ser mayor a 100 mb, es mas, ya desde los 50 mb salta una alerta.

Estas desarrollando tus Juegos en Unreal Engine/Godot/Unity mal

▶

Quiero compartir una situación reciente que viví mientras desarrollaba, la cual subraya la importancia crítica de emplear sistemas de respaldo de código como Git y GitHub.

Estaba editando un Blueprint simple para un portal en mi menú de selección de mundos. De repente, Unreal Engine se cerró (crachó), algo común en el motor. El problema vino al intentar reabrirlo: el archivo se había corrompido en mi Mac (aunque por suerte pude abrirlo en Windows, lo que indica un problema de plataforma y no del archivo en sí).

Este incidente me recordó la necesidad de proteger el trabajo.

El Riesgo del Desarrollo con Motores de Juego

La situación que viví es el peor escenario para cualquier desarrollador, y el riesgo es aún mayor en motores como Unreal o Unity:

1. Corrupción de Archivos: Un crash, una actualización fallida o un error al editar pueden corromper un archivo vital del proyecto.
2. Archivos Binarios y Estructurados: A diferencia del código de texto plano (como en Laravel o Flutter), los archivos de Unreal son a menudo binarios o están estructurados internamente de una manera que resulta incomprensible y difícil de reparar manualmente (ej: Blueprints compilados o archivos de configuración internos).
3. Pérdida de Tiempo: Intentar recuperar un nivel o un Blueprint complejo puede tomar días, generando frustración y la decisión de comenzar de nuevo.
4. Anécdota del Desarrollador: Un conocido desarrollador indie (Knu, que usa Unity) comentó que perdió varias horas tratando de rescatar un proyecto que simplemente se negaba a abrir. Si hubiera usado Git, el problema se habría solucionado en minutos.

Git y GitHub: Tu Seguro de Vida Digital

El uso de Git (versionamiento local) y GitHub (respaldo en la nube) elimina esta preocupación por completo.

a. Recuperación Instantánea (Git Checkout)
Yo tengo más de 245 commits en mi proyecto de Unreal. Si un archivo se corrompe:

• No Hay Preocupación: No tengo que perder tiempo "pariendo" una solución.
• Volver al Pasado: Simplemente copio el hash del último commit estable, ejecuto git checkout [commit_hash], y el proyecto vuelve inmediatamente a un estado de trabajo seguro. Perdemos solo el trabajo realizado desde ese último commit, pero salvamos todo el proyecto.

b. Respaldo en la Nube (GitHub)

GitHub añade una capa de protección:

• Disaster Recovery: No importa si la computadora o incluso el país explota; el proyecto está seguro en la nube.
• Sincronización: Puedo usar otra computadora y hacer un simple git pull para traerme los cambios, o directamente clonar el repositorio en un equipo nuevo.

⏱️Recomendación Clave: Empieza Ahora

Es fundamental adoptar la costumbre de respaldar el código desde el inicio del proyecto.

Motivo: Los proyectos de Unreal crecen muy rápido. Si esperas a tener varios Gigabytes, el proceso inicial de subir (hacer el primer git push) se volverá lento y tedioso, requiriendo una excelente conexión a Internet y tiempo de espera prolongado.