Beast Card Clash utiliza un modelo de colaboración directa: los colaboradores se añaden directamente al repositorio en lugar de hacer un fork. Esto mantiene el flujo de trabajo simple y permite a los colaboradores crear ramas sin fricciones.

Para solicitar acceso de colaborador, ponte en contacto con @Andresit1524 en GitHub. Una vez añadido, podrás clonar el repositorio y enviar ramas directamente.

Prerrequisitos

Antes de comenzar, asegúrate de tener instalado lo siguiente:

• Godot 4.6: El motor utilizado para compilar y ejecutar Beast Card Clash. Descárgalo desde godotengine.org.
• Git + Cuenta de GitHub: Necesitas tener Git en tu equipo y una cuenta de GitHub para solicitar acceso y enviar ramas.
• Plantillas de exportación de Godot: Necesarias para exportar el juego.
• Editor de código: Se recomienda Visual Studio Code.

Opcional:

• .NET SDK 8 o superior: Solo es necesario si trabajas en scripts de C#.
• Versión .NET de Godot 4.6: Requerida para el soporte de C#.

Clonar el repositorio

Una vez que tengas acceso de colaborador, clona el repositorio en tu equipo:

git clone https://github.com/Andresit1524/beast_card_clash
cd beast_card_clash

Luego, abre la carpeta del proyecto en Godot 4 para que el motor genere sus archivos de configuración locales (.godot/).

Configuración del espacio de trabajo en VS Code

Si utilizas Visual Studio Code:

1. Instala la extensión godot-tools: Busca godot-tools en el panel de Extensiones de VS Code e instálala.
2. Abre primero el proyecto en Godot: Inicia Godot y abre el proyecto. Godot generará la carpeta .godot/.
3. Utiliza la configuración compartida de .vscode/: El repositorio incluye un directorio .vscode/ con configuraciones compartidas. No modifiques estos archivos.

No edites ni elimines archivos dentro de .vscode/. Cambiar estas configuraciones afecta a todos los colaboradores que abran el proyecto en VS Code.

Flujo de trabajo en Git

Nunca trabajes directamente sobre main. Todos los cambios deben pasar por una rama y un pull request.

1. Crea una nueva rama: Utiliza un nombre de rama descriptivo.

   git checkout -b feature/nueva-carta
   

   • feature/: Añadir nueva funcionalidad.
   • fix/: Corregir un error (bug).
2. Realiza tus cambios: Sigue las directrices de estilo de código.
3. Prepara y confirma tus cambios (commit):

   git add .
   git commit -m "Add fire element card resource"
   

4. Envía tu rama:

   git push origin feature/nombre-de-tu-rama
   

5. Abre un pull request: Ve a GitHub y abre un pull request hacia main.

Referencia de nomenclatura de ramas

feature/new-card          # Añadir un nuevo tipo de carta
feature/dice-animation    # Añadir una característica visual
fix/main-menu-bug         # Corregir un error específico
fix/audio-loop-glitch     # Corregir un problema de audio

Mantén los nombres de las ramas en minúsculas y separados por guiones. Evita nombres vagos como fix/stuff o feature/update.

Páginas relacionadas

• Estilo de código
• Descripción general de la arquitectura