View on GitHub

UE4GitPlugin

Unreal Engine 4 Git LFS 2 Source Control Plugin (beta)

Download this project as a .zip file Download this project as a tar.gz file

Unreal Engine 4 Git Source Control Plugin

release Git Plugin issues Join the chat at https://gitter.im/SRombauts/UE4GitPlugin UE4GitPlugin is a simple Git Source Control Plugin for Unreal Engine 4.18.

Developped and contributted by Sébastien Rombauts 2014-2017 (sebastien.rombauts@gmail.com)

You need to install it into your Project Plugins/ folder, and it will overwrite (replace) the default “Git (beta version)” Source Control Provider with the “Git LFS 2” plugin.

Have a look at the Git Plugin Tutorial on the Wiki.

Written and contributed by Sebastien Rombauts (sebastien.rombauts@gmail.com)

Source Control Login screen to create a new workspace/a new repository:

History menu entry to look a the changelog of an asset:

Visual Diffing of two revisions of a Blueprint:

Merge conflict of a Blueprint:

Supported features

What cannot be done presently

Known issues

Getting started

Quick demo of the Git Plugin on Unreal Engine 4.12 (preview) Git Plugin on Unreal Engine 4.12 (preview)

Install Git

Under Windows 64bits, you should install the standard standalone Git for Windows (now comming with Git LFS 2 with File Locking) with default parameters, usually in “C:\Program Files\Git\bin\git.exe”.

Then you have to configure your name and e-mail that will appear in each of your commits:

git config --global user.name "Sébastien Rombauts"
git config --global user.email sebastien.rombauts@gmail.com

Install this Git Plugin (dev) into your Game Project

Unreal Engine comes with a stable version of this plugin, so no need to install it.

This alternate “Git development plugin” needs to be installed into a subfolder or your Game Project “Plugins” directory (that is, you cannot install it into the Engine Plugins directory):

<YourGameProject>/Plugins

You will obviously only be able to use the plugin within this project.

See also the Plugins official Documentation

Activate Git Source Control for your Game Project

Load your Game Project in Unreal Engine, then open:

File->Connect To Source Control... -> Git
Project already managed by Git

If your project is alreay under Git (it contains a “.git” subfolder), just click on “Accept Settings”. This connect the Editor to your local Git repository (“Depot”).

Project not already under Git

Otherwise, the Git Plugin is able to create (initialize) a new local Git Repository with your project Assets and Sources files:

Click “Initialize project with Git” that will add all relevant files to source control and make the initial commit with the customizable message. When everything is done, click on “Accept Settings”.

Using the Git Source Control Provider in the Unreal Engine Editor

The plugin only interacts with you local Git repository (“Depot”), not with the remote server (usually “origin”).

It display Git status icons on top of assets in the Asset Browser:

TODO:

See also the Source Control official Documentation

License

Copyright (c) 2014-2017 Sébastien Rombauts (sebastien.rombauts@gmail.com)

Distributed under the MIT License (MIT) (See accompanying file LICENSE.txt or copy at http://opensource.org/licenses/MIT)

How to contribute

GitHub website

The most efficient way to help and contribute to this wrapper project is to use the tools provided by GitHub:

Contact

Coding Style Guidelines

The source code follow the UnreaEngine official Coding Standard:

See also