A quick setup/intro
The latest version can be found here.
This was the latest when I was making this walkthrough.
Fire up the installer after you download it.
You will hit a screen that looks like this.. Please pick the options I have to make sure things work.
This one is the very important option. Again, please pick this option.
Fire up this one. Git GUI. This thing works well and makes the process quite easy.
This is what it will fire up.
Hit the help menu. Click the 'Show SSH key' option. You will need an SSH key to use Gitcession.
Click 'Generate Key'
It's going to ask you for a password. You don't need to use one (so you can use a blank if you want) but I do. If you do it is going to ask you for this password every time you clone or push to/from the server.
OK so you now have a pub/priv key pair. This is the pub key. Click the copy button. Then...
Head to the website! Click on your name. Then click on
The update your Account link. Scroll down and you will find
This. A text box wanting your public key. Paste it in and
Like this.... Then hit the update your account button. Click the 'Project List'
Then pick a save you want to play. Well I want to play Roldethulon. After clicking on it.. pick
Source! Then pick...
"How to get the code" It will give you the git details
Copy this. You will need the details to do the 'Clone'
Jump back to git GUI. Click 'Clone Existing Repository'
In the 'Source Location' paste the git details you got from the gitcession page. In the destination put the full path to where you want the save to end up. So I created an empty folder called Roldethulon next to my other saves. When I fire up DF it will use this name instead of 'Region 1 or 2 or 3' Mash the clone button. It will then pop this up.
Type in yes and hit ok. You actually have to type yes.
Hit ok. When it is done. It will pop up this. This is the current 'git' status. You will use this to do all the branching, pushing.
So to make sure you keep the base save 'clean' click the Branch menu and pick Create.
This allows you to create your own 'branch' of the save. Give it a name. Something descriptive or just your username.
So I just put this name in for my new Branch. Then mash the Create button. Then back on the main window mash the Push button to push the new branch up to the server. When you do it will throw an error because you haven't set everything up yet. Mash ok.
Now you want to click options, its under Edit.
Now I am going to assume you are going to play more than one save, so lets fill in some details under global. This will mean we are sorted from now on. Mash save and lets try that push again.
Highlight the branch you just created.. and press Push. This will put the data up onto the server. This will allow anybody to pull your branch.
It will thow a window like this. Just mash on the close button. You are pretty much good to go, play wise. But I'll just show you a few things to allow you to your progress up...
So, a quick look at the changes on the web site.. as you can see the branch I just created is there.
And when you fire up DF you will be able to see the save.
Now, lets pretend I actually got DF running inside that windows VM.. and I did play and then I saved. Lets look at what would happen. Switch back to Git GUI, and press 'Rescan'. As you can see it pulled in the changed files. (I created some dummy files). Type in a comment. It could be good to put some details of what has recently happened in the event somebody else wants to pick up the save.
Click the "Stage changed" button. This will flag all the files to be committed. Hit yes.
Then mash commit. This will get the current state of the save added to your 'local' git repo. This will allow you to roll things backwards if you want to.Now mash push.
As per last time select your branch and mash push.
And its done again.
So that is a guide to all the basic things you need. You can clone, create branches and push changes.. The last one is the one you will do most of.. Stage and then push.
Please message me or email me if you need a hand!