How to Create a Local Copy of a Git Repository - Rise-of-Nations-Team/Rise-of-Nations GitHub Wiki

This guide is created for use with Github Desktop, Windows, and the Steam version of Hearts of Iron IV with the default launcher. Most steps will work regardless of your configuration, but keep in mind if you want to do something different: most of our team uses this configuration. It would be much more difficult to troubleshoot certain issues if you're not.

Creating a Local Copy of the Mod

  • Launch the Hearts of Iron IV launcher. Then click Mod Library, then UPLOAD MOD, then CREATE A MOD.
  • For Name, make it Rise of Nations [Beta] to match the mods name. Version can be made anything. For Directory, make it mod/Rise-of-Nations. For Tags, it doesn't matter.
  • Click CREATE MOD, then click on Playsets, and add the new Rise of Nations to your playset. Then hover your mouse over the newly created mod, click the three dots on the right, then click on it, and Show in Folder. Finally, delete the Rise-of-Nations folder.

Installing Github Desktop:

  • For Windows and MacOS use, download and install Github Desktop using the link here. For Linux users, there is a community-made port that can be downloaded here.

  • Once Github Desktop is open, click on File in the top left, Clone Repository, and then 'URL'.

  • For URL or username/repository, copy-paste https://github.com/stuffi3000/Rise-of-Nations into it.

  • For Local path, click Choose. Navigate to Documents, then Paradox Interactive, then Hearts of Iron IV, and then, Mod.

  • Click Clone, and then Github Desktop will download the entire repository onto your desktop, which may take some time.

  • For the final step, right-click Current Repository in Github Desktop, then Show in Explorer. Open descriptor.mod. With that still open, go back one folder to Mod, and open Rise-of-Nations.mod. Then copy paste the first line from descriptor.mod to overwrite Rise-of-Nations.mod's.

  • If everything here was done correctly, you should have a bootable local copy of the mod that is linked to the Github branch you currently have loaded.

  • You can check for updates on a branch manually by clicking the Fetch Origin button, but Github Desktop will also do it for you.

  • During some parts of the month, Github Desktop will be more up-to-date with development compared to other platforms. When this happens, you can only play with others using this method until we next update the Steam version.

This guide was originally made by Biccy for RT56. All credit to him.