Up to date

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

Version control systems¶

Úvod¶

Godot aims to be VCS-friendly and generate mostly readable and mergeable files.

Version control plugins¶

Godot also supports the use of version control systems in the editor itself. However, version control in the editor requires a plugin for the specific VCS you're using.

As of July 2023, there is only a Git plugin available, but the community may create additional VCS plugins.

Oficiální zásuvný modul Git¶

Using Git from inside the editor is supported with an official plugin. You can find the latest releases on GitHub.

Dokumentaci jaj používat Git plugin můžete nalézt na hejich wiki.

Soubory k vyloučení z VCS¶

Poznámka

This lists files and folders that should be ignored from version control in Godot 4.1 and later.

The list of files of folders that should be ignored from version control in Godot 3.x and Godot 4.0 is entirely different. This is important, as Godot 3.x and 4.0 may store sensitive credentials in export_presets.cfg (unlike Godot 4.1 and later).

If you are using Godot 3, check the 3.5 version of this documentation page instead.

There are some files and folders Godot automatically creates when opening a project in the editor for the first time. To avoid bloating your version control repository with generated data, you should add them to your VCS ignore:

.godot/: This folder stores various project cache data.
*.translation: These files are binary imported translations generated from CSV files.

You can make the Godot project manager generate version control metadata for you automatically when creating a project. When choosing the Git option, this creates .gitignore and .gitattributes files in the project root:

Creating version control metadata in the project manager's New Project dialog — Creating version control metadata in the project manager's **New Project** dialog¶

In existing projects, select the Project menu at the top of the editor, then choose Version Control > Generate Version Control Metadata. This creates the same files as if the operation was performed in the project manager.

Práce se systémem Git v systému Windows¶

Většina klientů systému Git pro Windows je nakonfigurována s parametrem core.autocrlf nastaveným na true. To může vést k tomu, že soubory budou v systému Git zbytečně označeny jako změněné, protože jejich konce řádků budou automaticky převedeny. Je lepší nastavit tuto volbu jako.

It is better to set this option as:

git config --global core.autocrlf input

Creating version control metadata using the project manager or editor will automatically enforce LF line endings using the .gitattributes file. In this case, you don't need to change your Git configuration.