Git es una herramienta/software de control de versiones, pensado para ser usado cuando se manejan múltiples archivos en un proyecto.

GitHub es un Sitio Web que hace de "host" para Git con algo llamado "Repositorio", en donde se pueden visualizar/clonar/editar,etc. dichos archivos de una manera fácil.

En este proyecto sera la principal herramienta para editar los assets, archivos, scripts,etc. dentro del juego o también, añadir e eliminar.

Instalación de Git y GitHub

1. Se debe primero crear una cuenta de GitHub (https://github.com/)

2. Después de crear la cuenta, se puede instalar GitHub Desktop ("Como GitHub en forma de app") Si es que se usa Windows.

3. Se puede ahora instalar Git a través de su sitio oficial. (https://git-scm.com/) /// Si usas Windows, instala Git Bash, una app de Git en donde se puede correr ciertos códigos (Git Bash sale como opción de instalación en el instalador de Git).

4. Después de instalar Git, Abre la terminal (Git Bash si lo tienes) y coloca los datos de tu cuenta de GitHub

   • git config --global user.name "Usuario"
   • git config --global user.email "tucorreo@ejemplo.com"

Con eso Terminaría la instalación de Git y GitHub (Para tener en cuenta, usualmente en Git no sale textos de confirmación o de estar correcto en CIERTOS comandos como "git add .")

Clonacion de Repositorio

En este caso la clonación es descargar una copia exacta del juego/programa desde GitHub a tu computadora. La diferencia con una descarga normal (como un archivo .zip) es que la carpeta clonada se queda con un "cable invisible" conectado a internet, lo que permite enviar y recibir actualizaciones del proyecto.

Pasos para clonar (Usando GitHub Desktop)

1. Entrando al Repositorio del programa o proyecto habrá un botón verde que dice "Code", al darle aparecerán 3 opciones de la cual se elige URL, copia ese link.

2. Entra a GitHub Desktop, ve arriba a la izquierda, dale click a File -> Clone repository.

3. Elige la pestaña URL, pega el enlace que copiaste y elige en qué carpeta de tu PC quieres que se guarde el proyecto.

4. Dale al botón Clone y espera a que se descargue.

Y listo, has clonado exitosamente!

Instalación del Repositorio en Godot

Para poder empezar a trabajar en el juego, debes importar (en este caso el clon) a Godot el archivo base .godot, se hace así:

1. Abre Godot Engine.

2. A la derecha, dale click al botón Import (Importar).

3. En la casilla Browse (Examinar), busca la carpeta donde clonaste el proyecto.

4. Selecciona el archivo llamado project.godot y dale a Open (Abrir).

Y listo, el proyecto deberá salir en el menu.

Uso de Git en el Proyecto

(hecho con IA, si no entienden algo, digan.)

Para entender Git, imagina que estás armando una caja de envíos. Modificas cosas, las metes en la caja, le pones una nota por fuera diciendo qué lleva, y luego la mandas por correo.

Estos son los únicos comandos que necesitas saber y cómo usarlos en tu día a día (se escriben en la terminal/Git Bash dentro de la carpeta del juego):

1. git pull origin main (Traer los cambios de la nube)

¿Qué hace? Descarga todo lo nuevo que tus compañeros hayan subido a GitHub mientras tú no estabas.

• Cuándo usarlo: SIEMPRE antes de abrir Godot. Si no lo haces, puedes trabajar sobre una versión vieja del juego y causar problemas al juntar los archivos.

2. git add . (Meter los archivos a la caja)

¿Qué hace? Le dice a Git: "Quiero que guardes todos los archivos que acabo de modificar o crear dentro de Godot". (El punto . significa "todo lo que cambió aquí dentro").

• Cuándo usarlo: Cuando termines de trabajar en tu sesión del día y ya hayas cerrado Godot. (Recordar que si no sale nada, esta bien. por alguna razón git es así)

3. git commit -m "Tu mensaje aquí" (Cerrar y etiquetar la caja)

¿Qué hace? Guarda oficialmente tus cambios en tu computadora y le pega una etiqueta (el mensaje) para que los demás sepan qué hiciste.

• Ejemplo: git commit -m "Añadido el salto del jugador y arreglado el bug de la animación"

• Cuándo usarlo: Justo después de usar git add ..

4. git push origin main (Enviar la caja por correo)

¿Qué hace? Sube tus cambios guardados desde tu computadora directamente a la página de GitHub, para que el resto del equipo pueda descargarlos.

• Cuándo usarlo: Al final del todo, justo después del git commit. Una vez que termine de cargar, tu trabajo estará a salvo en internet.