Author: matt

Step 1: Initialize Git in Your Project

Navigate to your project directory and initialize a Git repository:

cd /path/to/your/project
git init

Step 2: Add a .gitignore File for Godot

Create a .gitignore file to exclude unnecessary files from being tracked. Here’s a recommended .gitignore for a Godot project:

# Godot specific
.import/
.export/
*.godot
*.mono/

# OS specific
.DS_Store
Thumbs.db

# Compiled files
*.log
*.tmp

Save this file in the root of your project directory.

Add and commit the .gitignore file:

git add .gitignore
git commit -m "Add .gitignore for Godot"

Step 3: Set Up Git LFS

Install and configure Git LFS:

git lfs install

Track specific file types used in Godot:

git lfs track ".png" ".jpg" ".tga" ".wav" ".ogg" ".glb" "*.gltf" "*.blend"

This creates a .gitattributes file in your project. Add and commit it:

git add .gitattributes
git commit -m "Configure Git LFS"

Step 4: Add Your Project Files to Git

Now, add all the project files to the Git repository:

git add .
git commit -m "Initial commit of Godot project"

Step 5: Connect to a Remote Repository (Optional)

If you want to push your project to a remote repository (e.g., GitHub, GitLab), follow these steps:

Create a new repository on your Git hosting platform. Add the remote repository URL:

git remote add origin https://github.com/username/repository.git

Push the repository to the remote:

git push -u origin main

Step 6: Verify Git LFS

Ensure Git LFS is correctly tracking the designated file types:

git lfs ls-files

Final Notes

The .gitignore ensures that generated files and temporary files are not added to your repository.
The .gitattributes ensures large binary files are handled efficiently by Git LFS.
Once set up, collaborate and manage your Godot project effectively with Git and Git LFS!