Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Sistemas de Control de Versiones

Introducción

Godot intenta ser amigable a VCS y genera mayormente archivos legibles y combinables.

Plugin de control de versiones

Godot además soporta el uso de sistemas de control de versiones desde el editor mismo. Sin embargo, el control de versiones en el editor requiere de un plugin específico para el VCS que se está usando.

Hasta julio de 2023 sólo hay disponible un plugin de Git, pero la comunidad podrá crear plugins para otros SCV.

Plugin Git oficial

El uso de Git desde el editor está soportado con un plugin oficial. Puedes encontrar las versiones más recientes en GitHub.

Documentación sobre cómo utilizar el plugin de Git puede encontrarse en su wiki.

Archivos a excluir del VCS

Nota

Esto lista los archivos y carpetas que deberian ser ignorados en el control de versiones en Godot 4.1 y posteriores.

La Lista de archivos o carpetas que deben ser ignoradas del control de versiones en Godot 3.x y Godot 4.0 son completamente diferentes. Esto es importante, debido a que tanto Godot 3.x como Godot 4.0 pueden guardar credenciales sensibles en export_presets.cfg (a diferencia de Godot 4.1 y posteriores versiones).

Si estas usando Godot 3, revisa en su lugar la versión 3.5 en la pagina de documentación.

Cuando abres un proyecto en Godot por primera vez, el programa automáticamente crea algunos archivos y carpetas. Para evitar sobrecargar tu repositorio de control de versiones con datos generados, deberías añadirlos al archivo .gitignore:

  • .godot/: Esta carpeta almacena diversos datos de caché del proyecto.

  • *.translation: Esos son archivos binarios de traducciones importadas generadas desde archivos CSV.

Puedes hacer que el administrador de proyectos de Godot genere automáticamente metadatos para el control de versiones al crear un proyecto. Al elegir la opción Git se crean los archivos .gitignore y .gitattributes dentro de la carpeta raíz del proyecto:

Creando metadatos para el control de versiones en el cuadro de diálogo Proyecto Nuevo del administrador de proyectos

Creando metadatos para el control de versiones en el cuadro de diálogo Proyecto Nuevo del administrador de proyectos

En proyectos existentes, selecciona la menú Proyecto en la parte superior del editor, luego selecciona Control de Versiones > Generar Metadatos para el Control de Versiones.

Trabajar con Git en Windows

La mayoría de los clientes de Git para Windows están configurados con el core.autocrlf en ``true`. Esto puede llevar a que los archivos sean marcados innecesariamente como modificados por Git debido a que sus terminaciones de línea se convierten automáticamente de LF a CRLF.

Es mejor configurar esta opción como:

git config --global core.autocrlf input

Al crear metadatos para el control de versiones utilizando el administrador de proyectos o el editor, se aplicarán automáticamente los saltos de líneas LF utilizando el archivo .gitattributes. En este caso, no necesitas cambiar la configuración de Git.