git setup example with
git-lfs for Unreal Engine 4 projects.
This template implies some conventions to be used correctly, which are discussed below. You should be able copy and paste them into your project's
README.md if you want to.
Repository structure is fixed, and it only has a few toplevel directories. Every other directory or file is ignored.
git-lfs management rules are mostly defined for file types, and not paths, however there can entire paths marked to be managed by
git-lfs. Without a special note, expect only type-based rules apply to a directory.
C++ source code is stored under the
/Source path. As with most other directories, this directory is managed by standard git (and not
git-lfs). That means no blobs. Do not put here any
.zips and other binaries. Only text files are allowed.
Generated text files can reside in the local
/Source dir, but should be ignored by git with additional entries in
Engine and game config files.
Game plugins. Every plugin lives in a subdirectory of the
/Plugins dir. A plugin internal directory structure is not strictly documented, so there are no assumptions on how a plugin is structured.
It may be useful to use git submodules to manage plugins in a more robust manner.
It is expected that each plugin will have it's own
.gitignore file in it's subdirectory, as well other required specific git tweaks.
Game assets in Unreal Engine formats,
.umap. Only those two file types are allowed, everything else is ignored.
This directory is managed entirely by
/RawContent is a directory where you store assets in their source formats, in contrast to
/Content, where assets are stored in the engine format (after the import). Having an asset in a source format is useful when you're still making updates to it. It may be a good idea to also have separate repos for managing work-in-progress assets (maybe in smaller collections or even idividually).
.gitattributesto your project.
Take special care when working with plugins. Plugin structure is not very well defined, so you will be able to mess the git repo up with big files if you commit them to a plugin directory.
This repo uses UNIX-style line endings and UTF-8. Make sure every line in a text file is ended with a newline (especially the last line in a file, git should notify you if you've lost it). This is due to how lines are defined. Feel free to search the web for more info on why to end every file with an "empty line".
git checkout -b my-new-feature)
git commit -am 'Add some feature')
git push origin my-new-feature)