Git LFS

Git LFS is a tool for making Git repositories work well with big, binary files. Thrive includes a lot of big asset files that are needed to run the game. These are stored with Git LFS to keep our main repo from bloating and slowing things down.

Read Access

The LFS repository is configured to not need any login details when reading data. So cloning Thrive and pulling the asset files does not need any login details.

For `git lfs pull` to work you must first install git lfs. If the only thing you want to download are the assets, then from that linked page you only need git and git-lfs, you can ignore the other tools if you don't want to compile the game.

Write Access

For writing (sending new file) to the Git LFS repo you need to create a token to access LFS in ThriveDevCenter. To do so first login there using your development forum account: https://dev.revolutionarygamesstudio.com/login

After logging in click your email under the top navigation. This will take you to https://dev.revolutionarygamesstudio.com/me where there is a button called "Generate Git LFS Token", press it. Then the token is either visible immediately or can be made visible by pressing the button to show the LFS token.

Now when you do a `git push` after modifying some LFS tracked file (before committing make sure that the big files are listed in the command `git lfs ls-files`) you will be asked for an username and a password. The username is your development forum email and the password is the LFS token that was created in the previous step.