Installation Guide - Revision history

CRER: Add note about linux

2023-08-29T20:19:37Z

Add note about linux

Mr Pops Alot: /* Method 3: GIT CLIENT */

2023-03-12T07:49:18Z

‎Method 3: GIT CLIENT

Mr Pops Alot: /* Method 1: AUTO-UPDATER */

2023-03-12T07:37:11Z

‎Method 1: AUTO-UPDATER

Vinumsabbathi at 20:41, 27 January 2023

2023-01-27T20:41:23Z

73.193.123.158: /* Method 2: GIT CLIENT */

2021-08-21T09:24:19Z

‎Method 2: GIT CLIENT

73.193.123.158: /* Method 2: GIT CLIENT */

2021-08-21T09:21:39Z

‎Method 2: GIT CLIENT

Rosenmann: Add category

2020-07-02T07:31:51Z

Add category

Lunashooter: Created page for Harris' installation guide

2019-06-07T03:28:04Z

Created page for Harris' installation guide

New page

=Method 1: DIRECT DOWNLOAD=

Installing an era game is piss simple. They're all portable, so all you need to do is decide where to put it. It really doesn't matter, so long as the directory's empty.
Once you've decided on a spot, just unpack the archive you downloaded there and you're good to go. It should look something like this afterwards. (photo is TW)
[[File:Install1.png|frame|If it doesn't look like the above, your encoding might be fucked. Try again with 7zip, or use method 2|left]]

 When you update, you MUST NOT UNPACK OVER AN EXISTING INSTALL. '''I REPEAT: YOU MUST NOT UNPACK OVER AN EXISTING INSTALLATION.'''
Doing this will break something, as between versions some files are removed all together, instead of just modified or added. What you should do, is either make multiple installation directories for different versions, or just delete the one you have (except for your sav folder, if you want to transfer saves) and reuse the directory.

=Method 2: GIT CLIENT=
Installing a game with a git client is a bit more involved, but updating requires virtually no effort. It does make you register for two accounts though, but all they need is an email. What you need to do first is grab a git client. The most noob friendly one I've found is GitKraken, so it'll be the one the guide's based around. Go here ( https://www.gitkraken.com/ ), and download the client. It's free. Once it's downloaded and installed, open it and you'll see this window:
[[File:Install2.png|center]]
 

Note that that first button is for GitHub, not GitGud. Our repositories are on the latter, which is why you need to make an account for both the Git, and for the client. 
Once you've gotten the GitKraken account made, next step is to create an account with GitGud/Sapphire here: https://accounts.sapphire.moe/app/users/add 
Note that sapphire sucks ass and is down a lot, so if you suddenly can't log in wait a few hours, it'll fix itself.

Once you've got both accounts set up, navigate to the Authentication tab in the GirKraken client Prefrences menu, which you get to by clicking the menu button to the right of your user icon in the top right, and generate a SSH key by clicking the "Generate a new Private/Public Key" button. They'll save to file, so just pick somewhere to keep them. Once you have that, go into your git user settings, and go down to SSH Keys. Paste your public key in here, and give it a name. This will allow you to clone via SSH, which is the easiest method.
After you've done that, navigate to https://gitgud.io/era-games and pick a game, for this guide we'll use TW.
Once you're on the game's page, you'll want to click the clone button, and copy the clone with SSH link.
[[File:Install3-2.png|center]]
 

On your GitKraken window, press either the folder icon in the top left, or the "Open a Project" button in the center of the screen. Click Clone, decide on a directory, and paste the SSH clone link into the URL field. It will automatically make a folder for the game, so you don't need to do like "Games\Era\TW", just make it "Games\Era" and the client will fill in the rest from the url. After that just press Clone.
[[File:Install4-2.png|center]]
 

You'll see a blue box in the top right of the client that shows the download progress, wait until it finishes. TW isn't a very big game so it shouldn't take more than a few minutes, even on the most Australian of internet connections.
After it's done, a banner will pop up at the top of the client, saying something like "Clone successful" and two buttons, one opens the clone and the other dismissing the banner. At this point, you're done with the installation, and can start playing. When you launch the program from here on out, it should automatically check for updates, and you can apply them by pressing the "Pull (fastforward if possible)" button at the top of the window with the repo opened.

← Older revision		Revision as of 20:19, 29 August 2023
Line 1:		Line 1:
		+	For running era games on Linux, refer to [[Common_Issues\| Common Issues]] after using any of the following methods.
	=Method 1: AUTO-UPDATER=		=Method 1: AUTO-UPDATER=
	This only works for [[eratoho TheWorld\|TW]], the [[Pedy's TW\|Neodev]] fork of TW, [[eraTohoK\|K]], and [[eraMegaten\|Megaten]], but those are the most popular era games anyway. For other era games, see Methods 2 and 3.		This only works for [[eratoho TheWorld\|TW]], the [[Pedy's TW\|Neodev]] fork of TW, [[eraTohoK\|K]], and [[eraMegaten\|Megaten]], but those are the most popular era games anyway. For other era games, see Methods 2 and 3.

@@ Line 1: / Line 1: @@
 =Method 1: AUTO-UPDATER=
-This only works for TW, the Neodev fork of TW, K, and Megaten, but those are the most popular era games anyway. For other era games, see Methods 2 and 3.
+This only works for [[eratoho TheWorld|TW]], the [[Pedy's TW|Neodev]] fork of TW, [[eraTohoK|K]], and [[eraMegaten|Megaten]], but those are the most popular era games anyway. For other era games, see Methods 2 and 3.
 Download the autoupdater: http://madhammer.club/files/era-updater.7z

@@ Line 1: / Line 1: @@
-=Method 1: DIRECT DOWNLOAD=
+Download the autoupdater: http://madhammer.club/files/era-updater.7z
 Installing an era game is piss simple. They're all portable, so all you need to do is decide where to put it. It really doesn't matter, so long as the directory's empty.</br>
@@ Line 9: / Line 15: @@
 Doing this will break something, as between versions some files are removed all together, instead of just modified or added. What you should do, is either make multiple installation directories for different versions, or just delete the one you have (except for your sav folder, if you want to transfer saves) and reuse the directory.
-=Method 2: GIT CLIENT=
+=Method 3: GIT CLIENT=
 Installing a game with a git client is a bit more involved, but updating requires virtually no effort. It does make you register for two accounts though, but all they need is an email. What you need to do first is grab a git client. The most noob friendly one I've found is GitKraken, so it'll be the one the guide's based around. <s>Go here ( https://www.gitkraken.com/ ), and download the client</s> Go to the discord and follow the instructions under the GitCracken Pin in development. Once it's downloaded and installed, open it and you'll see this window:
 [[File:Install2.png|center]]

← Older revision		Revision as of 07:31, 2 July 2020
Line 30:		Line 30:
	You'll see a blue box in the top right of the client that shows the download progress, wait until it finishes. TW isn't a very big game so it shouldn't take more than a few minutes, even on the most Australian of internet connections.		You'll see a blue box in the top right of the client that shows the download progress, wait until it finishes. TW isn't a very big game so it shouldn't take more than a few minutes, even on the most Australian of internet connections.
	After it's done, a banner will pop up at the top of the client, saying something like "Clone successful" and two buttons, one opens the clone and the other dismissing the banner. At this point, you're done with the installation, and can start playing. When you launch the program from here on out, it should automatically check for updates, and you can apply them by pressing the "Pull (fastforward if possible)" button at the top of the window with the repo opened.		After it's done, a banner will pop up at the top of the client, saying something like "Clone successful" and two buttons, one opens the clone and the other dismissing the banner. At this point, you're done with the installation, and can start playing. When you launch the program from here on out, it should automatically check for updates, and you can apply them by pressing the "Pull (fastforward if possible)" button at the top of the window with the repo opened.
		+
		+	[[Category:NewbieGuide]]

@@ Line 36: / Line 36: @@
 You'll see a blue box in the top right of the client that shows the download progress, wait until it finishes. TW isn't a very big game so it shouldn't take more than a few minutes, even on the most Australian of internet connections.
 After it's done, a banner will pop up at the top of the client, saying something like "Clone successful" and two buttons, one opens the clone and the other dismissing the banner. At this point, you're done with the installation, and can start playing. When you launch the program from here on out, it should automatically check for updates, and you can apply them by pressing the "Pull (fastforward if possible)" button at the top of the window with the repo opened.
 [[Category:NewbieGuide]]

@@ Line 10: / Line 10: @@
 =Method 2: GIT CLIENT=
-Installing a game with a git client is a bit more involved, but updating requires virtually no effort. It does make you register for two accounts though, but all they need is an email. What you need to do first is grab a git client. The most noob friendly one I've found is GitKraken, so it'll be the one the guide's based around. Go here ( https://www.gitkraken.com/ ), and download the client. It's free. Once it's downloaded and installed, open it and you'll see this window:
+Installing a game with a git client is a bit more involved, but updating requires virtually no effort. It does make you register for two accounts though, but all they need is an email. What you need to do first is grab a git client. The most noob friendly one I've found is GitKraken, so it'll be the one the guide's based around. <s>Go here ( https://www.gitkraken.com/ ), and download the client</s> Go to the discord and follow the instructions under the GitCracken Pin in development. Once it's downloaded and installed, open it and you'll see this window:
 [[File:Install2.png|center]]
 <br clear=all>
@@ Line 18: / Line 18: @@
 Note that sapphire sucks ass and is down a lot, so if you suddenly can't log in wait a few hours, it'll fix itself.
-Once you've got both accounts set up, head to the discord and follow the instructions under the GitCracken Pin in development.
+Once you've got both accounts set up, navigate to the Authentication tab in the GirKraken client Prefrences menu, which you get to by clicking the menu button to the right of your user icon in the top right, and generate a SSH key by clicking the "Generate a new Private/Public Key" button. They'll save to file, so just pick somewhere to keep them. Once you have that, go into your git user settings, and go down to SSH Keys. Paste your public key in here, and give it a name. This will allow you to clone via SSH, which is the easiest method.
 After you've done that, navigate to https://gitgud.io/era-games and pick a game, for this guide we'll use TW.
 Once you're on the game's page, you'll want to click the clone button, and copy the clone with SSH link.