November 12, 2023

Unreal git First steps

Preparation

  • You need microsoft account. Send me your email address associated with it.

If you do it - skip.

  • You need to install git - Standalone Installer - 64-bit Git for Windows Setup.

If you already have it - check for this option(Open any folder or desktop, right click, show more options - git bash here), if you have just skip to next step. If you dont have git bash here - delete Git and go through my steps.

During install all by default, but here is exceptions(some options is used by default but please double check it)

  • open git bash here is enabled(default but check)
  • use notepad as git default editor(change it)
  • git from command line and 3d party soft(default but check)

If you already have it skip this step.

When install it just skip sign in.

If he ask for your name and email put it from microsoft account(please ask me for your name if i not give you, it depends on you microsoft account)

  • Configure your name and email in git

Open any folder or desktop, right click, show more options - git bash here

Put this two command to gitbash(you can paste it with right click - paste - but check for some trash staff in command)

REPLACE DATA in "" with your data

(name and email put it from microsoft account(please ask me for your name if i not give you, it depends on you microsoft account))

(use commands one at a time, you can use notepad to more conveniently insert your data into the command, make sure to remove any bugs after pasting if they appear, , you can use the arrow buttons for navigation)

git config --global user.name "your name from microsoft acc"
git config --global user.email "[email protected]" 
reference

If you already have Visual Studio 2019, dont skip this and install 2022.

Better to close Visual studio Community installer(top window) and install Professional from window underneath. (optional)

During install check Game development with C++ option, and check for unreal engine installer in right menu.

When it installs and ask for sign in, just close.

Open you system disk(C:)

Make two new folder with name 1, 2

Put files from plugin archive to folder "1". (as you see there is no UEGitPlugin-3.15 folder, just go inside it in winrar)

Go here

C:\Program Files\Epic Games\UE_5.3\Engine\Plugins\Developer 

(or you folder where you put your unreal 5.3 files) and Make archive from folder GitSourceControl (for backup, in real i dont think you need it in future, but better do it)

After backing it up - delete all from folder GitSourceControl (you need empty folder).

Open new Explorer window and go here

C:\Program Files\Epic Games\UE_5.3\Engine\Build\BatchFiles

Now right click in empty space - and click open in Terminal

Put command in next line to command line and press Enter.

.//RunUAT.bat BuildPlugin -plugin="C:\1\GitSourceControl.uplugin" -package="C:\2"

Wait like 1-2 minutes.

If it says Build Successful and exit code=0 (Success) all ok, go next step, if you failed - text me, we fix it together.

Now open C:\2 (folder you create in first steps)

And copy content to (dont forget to delete all from GitSourceControl)

C:\Program Files\Epic Games\UE_5.3\Engine\Plugins\Developer\GitSourceControl

And copy "git-lfs.exe" from folder C:\1 too.

Connect to project

If you complete all step from preparation stage (if not i will kill you, really).

If link dont open or you dont see Repos - text me, sometimes i need to reinvite you.

  • Click Clone on the right
  • Copy url
  • Open GitHub Desktop and click Clone repository
  • Click on URL, paste repository url from previous step and select folder where you want to store project(SSD preffered)
  • GitHubDesktop promt you for login and password, get it from Generate Git Credentials button from dev.azure
  • Wait for download. After that GitHub Desktop ask you - click Initialize Git LFS.
  • Now just open project, go to plugins and check Git LFS 2 is enabled, if no - enable and restart Unreal
  • Now click in the bottom right to revision Control - Connect to Revision control
  • Select Git LFS2 as provider

Check again for your username and email. Name under "User Name" and "Uses Git LFS" must be the same. If anything wrong go to @Configure your name and email in git@ section and do it. If problem persist - just delete repo from GitHub Desktop app and repeat steps from cloning.

If all ok click accept settings.

Here is instruction how to use revision control in Unreal.