Differences

This shows you the differences between two versions of the page.

--- help:quickstart [2026/06/19 09:33] – external edit 127.0.0.1
+++ help:quickstart [2026/06/21 10:50] (current) – mcplayer
@@ Line 45: / Line 45: @@
 Installing Halyde 3 is a bit more of an involved process. Please note that Halyde 2 apps are **not compatible** with Halyde 3.
-There are 3 main ways of installing Halyde 3. You can either:
+There are 3 main ways of installing Halyde 3, but first you must pick the flavor, or branch, of Halyde 3 you would like to install.
-  * [[quickstart#installing_halyde_3_using_gitget|Install Halyde 2 and use the gitget tool]]
-  * [[quickstart#downloading_halyde_from_github|Download Halyde as a ZIP file from GitHub]]
+Currently there are 2 options available:
-  * [[quickstart#using_git_to_download_halyde|Use Git to download Halyde]]
+  * ''cutting-edge'', more stable (recommended to use)
+  * ''bleeding-edge'', newer but less stable (recommended for development)
+You can either:
+  * [[quickstart#installing_halyde_3_using_gitget|Install Halyde 2 and use the gitget tool to download Halyde 3]]
+  * [[quickstart#downloading_halyde_3_from_gitea|Download Halyde 3 as a ZIP file from Gitea]]
+  * [[quickstart#using_git_to_download_halyde_3|Use Git to download Halyde 3]]
 ----
@@ Line 59: / Line 65: @@
 The tool will prompt you for a repository name. Type ''Team-Cerulean-Blue/Halyde'' and hit Enter.
-Next, it will ask you for a branch name. You can choose between ''Pre-Alpha-3.0.0'', which is more stable but with not as many new features, or ''unfinished-ag2'', which has a lot more new features but may not be as stable. Type in your option and hit Enter.
+Next, it will ask you for a branch name. Type in the branch you chose in [[quickstart#installing_halyde_3|the previous section]] and hit Enter.
-Then, it will ask you where to download to. You should enter a drive short ID (like ''14e'' for example) and hit Enter.
+Then, it will ask you where to download to. You should enter a drive short ID (like ''b79'' for example) corresponding to where you want to install Halyde 3 and hit Enter.
-Finally, it will ask you to confirm the install path. It should look something like ''/mnt/14e/'', for example. Before confirming, check what you have entered in with the image below, keeping in mind that the branch should correspond to your selection, and the install path should correspond to your disk.
+Finally, it will ask you to confirm the install path. It should look something like ''/mnt/b79/''. Before confirming, check what you have entered in with the image below, keeping in mind that the branch should correspond to your selection, and the install path should correspond to your disk.
 {{:help:quickstart-c.png?400|}}
@@ Line 71: / Line 77: @@
 After confirming, the download process will start. This could take a few minutes, so wait for the completion message.
-Once finished, you can run ''boot <drive id>'', replacing ''<drive id>'' with the actual ID or short ID where you installed Halyde 3.
+Once finished, you can run ''boot <drive id>'', replacing ''<drive id>'' with the actual ID or short ID where you installed Halyde 3, like ''boot b79''.
+If you want to update Halyde 3, you will need to download it using ''gitget'' again. Currently, no version of ''gitget'' exists for Halyde 3 so you will need Halyde 2 to be able to update.
 ----
-===== Downloading Halyde from GitHub =====
+===== Downloading Halyde 3 from Gitea =====
-//This method requires that you have access to the folder where your drive is, or that you are using an OpenComputers emulator (like [[https://ocelot.fomalhaut.me/desktop|Ocelot]] which allows you to choose a folder for your drive. If you do not have that, try [[quickstart#installing_halyde_3_using_gitget|using gitget]].//
+//This method requires that you have access to the folder where your drive is. If you do not have that, try [[quickstart#installing_halyde_3_using_gitget|using gitget]].//
+To download Halyde 3 from Gitea, first you must locate the folder for the drive you want to install to. Instructions are provided for Minecraft and Ocelot.
+To do this, first locate your ''.minecraft'' folder. Then, go to ''.minecraft/saves/<the folder containing your world>/opencomputers/<the ID of your drive>''.
+If you are using Ocelot, the folder for you drive will be in the root of your Ocelot folder.
+This folder will be referred to as the "drive folder" in this guide. If you came from the guide for using Git, [[quickstart#using_git_to_download_halyde_3|return back now.]]
+Once you have found your drive folder, head to [[https://git.sting.lt/Cerulean-Blue/Halyde|the Halyde Git repo]] and click the branch icon as shown in Figure D.
+{{:help:quickstart-d.png?400|}}
+== Figure D ==
+Then, select the branch you chose in [[quickstart#installing_halyde_3|the previous section]].
+Click the blue "''<>'' Code" button, then click "Download ZIP". This should start downloading a zip file containing Halyde 3.
+Once it's done downloading, extract the zip file into your drive folder. You have now installed Halyde 3.
+To update, you must redownload the zip file and paste it into the folder. This will update your Halyde system files without touching files that it shouldn't.
 ----
-===== Using Git to download Halyde =====
+===== Using Git to download Halyde 3 =====
-//This method requires that you have access to the folder where your drive is, or that you are using an OpenComputers emulator (like [[https://ocelot.fomalhaut.me/desktop|Ocelot]] which allows you to choose a folder for your drive. If you do not have that, try [[quickstart#installing_halyde_3_using_gitget|using gitget]].//
+//This method requires that you have access to the folder where your drive is. If you do not have that, try [[quickstart#installing_halyde_3_using_gitget|using gitget]].//
+//This method also involves using the terminal, as well as knowledge of how to use one. If you are not comfortable with that, [[quickstart#downloading_halyde_3_from_gitea|download Halyde 3 from Gitea]].//
+//This method also requires you to install [[https://git-scm.com/|Git]]//.
+First, you must find your drive folder. This is explained in [[quickstart#downloading_halyde_3_from_gitea|downloading from Gitea]].
+Then, open a terminal and go to your drive folder. Once you're there, run ''git clone https://git.sting.lt/Cerulean-Blue/Halyde.git''. Then, run ''git switch <branch name>'', replacing ''<branch name>'' with the branch you chose in [[quickstart#installing_halyde_3|the previous section]].
+Once you've done that, Halyde 3 should be installed. To update, run ''git pull''.