Setup Git & LFS (5 Mins)

Stop emailing zip files. This guide sets up a robust Git workflow with LFS (Large File Storage) support, which is mandatory for Unreal binary assets.

Step 1: Install GitHub Desktop

Download and install GitHub Desktop. It provides a visual interface for Git management.

Step 2: Create the Repo

1. In GitHub Desktop: File > New Repository.
2. Name: MyGame
3. Local Path: Choose a folder on your SSD.
4. Git Ignore: Select UnrealEngine. (Crucial step!)
5. Click Create Repository.

Step 3: Enable LFS (Large File Storage)

Unreal assets are binaries. Git needs LFS to handle them.

1. In GitHub Desktop: Repository > Show in Explorer.
2. Create a text file named .gitattributes.
3. Paste this configuration into it:

   code Text
4. *.uasset filter=lfs diff=lfs merge=lfs -text
   *.umap filter=lfs diff=lfs merge=lfs -text
   *.upk filter=lfs diff=lfs merge=lfs -text
   *.fbx filter=lfs diff=lfs merge=lfs -text
   *.png filter=lfs diff=lfs merge=lfs -text
     

5. Commit this file: "Setup LFS".
6. Click Publish Repository.

Step 4: Connect Unreal

1. Move your .uproject and Content folder into this new repository folder.
2. Open Unreal Engine.
3. Source Control (Bottom Right) -> Connect.
4. Select Git (Beta).

You are now ready to use SafeSave.