From 5f48b113d8ae45ae094334a26ed4e16300d1dd72 Mon Sep 17 00:00:00 2001 From: MicrocontrollersDev <66657148+MicrocontrollersDev@users.noreply.github.com> Date: Tue, 9 Apr 2024 13:34:04 -0500 Subject: [PATCH] modrinth guide and fix some prism guide issues --- docs/launcher/home.md | 8 +++++- docs/launcher/modrinth_win.md | 47 +++++++++++++++++++++++++++++++++++ docs/launcher/prism_gnu.md | 8 +++--- docs/launcher/prism_mac.md | 8 +++--- docs/launcher/prism_win.md | 12 ++++----- mkdocs.yml | 2 ++ 6 files changed, 70 insertions(+), 15 deletions(-) create mode 100644 docs/launcher/modrinth_win.md diff --git a/docs/launcher/home.md b/docs/launcher/home.md index 004452ce..dd3520be 100644 --- a/docs/launcher/home.md +++ b/docs/launcher/home.md @@ -2,8 +2,14 @@ - Click the links below or use the sidebar navigation to find the list you want. +## Modrinth App + +- [Windows](https://alternatives.microcontrollers.dev/launcher/modrinth_win) +- MacOS coming soon +- Linux coming later + ## Prism Launcher - [Windows](https://alternatives.microcontrollers.dev/launcher/prism_win) - [MacOS](https://alternatives.microcontrollers.dev/launcher/prism_mac) -- [Linux](https://alternatives.microcontrollers.dev/launcher/prism_gnu/) +- [Linux](https://alternatives.microcontrollers.dev/launcher/prism_gnu) diff --git a/docs/launcher/modrinth_win.md b/docs/launcher/modrinth_win.md new file mode 100644 index 00000000..1941164b --- /dev/null +++ b/docs/launcher/modrinth_win.md @@ -0,0 +1,47 @@ +# Modrinth App + +Modrinth App is an incredibly powerful launcher that makes managing your mods and modded instances much easier. It can do everything the official launcher can do, but allows for much more customization and ease of access. The official launcher has had several issues that have taken weeks to fix or are currently still not fixed, despite their severity. For modded and vanilla users alike, it is recommended to switch to Modrinth Launcher for an issue-less experience. + +This guide will explain the install process for Modrinth, as well as how we can use it for SkyClient. Please take the time after setting up to better learn your way around the launcher, as you may end up using it as your go-to launcher from now on! + +## How to Install (Windows) + +- Despite looking long, this is a very simple process and should only take a few minutes! This guide will also assume you are migrating from SkyClient, but steps will be largely the same, except for the migrating data section. + +### Step 1 - Installing Modrinth + +[Download Modrinth App](https://modrinth.com/app). It should automatically recommend the correct version to download (a `.msi`). Once it is finished downloading, run it. It may warn you that it is an executable file and could be malicious. Press `OK` and continue the setup process. + +### Step 2 - Logging in + +After launching, it will then ask you to log into your Microsoft account so that it can log you into your Minecraft account. Follow the on screen instructions. It may then ask you to sign into Modrinth. You are not tied down to one method, you can link multiple accounts later. Modrinth will now guide you through how to use the app, please pay attention! + +### Step 3 - Creating an Profile/Instance + +This guide will focus on Forge 1.8.9, but steps for other versions should also be obvious. + +Click on the green `+` button on the bottom left of the app. Make sure the `Custom` tag is selected. Give it an icon if you wish, any name you want, and set the Loader to `Forge`, and Game version to `1.8.9`. Then press `+ Create`. + +### Step 4 - Installing our mods / SkyClient + +Now that we've installed Forge 1.8.9, we need to move all our mods to the new Modrinth App folder. To do that, we'll right click our new instance and press `Open folder`. A File Explorer window should open, this is the equivalent of your ".minecraft" for this instance. Now, open a new File Explorer by either pressing `Win + E` on your keyboard or right clicking the file explorer icon and pressing "File Explorer". Navigate to your old .minecraft folder, which is `C:\Users\USER\AppData\Roaming\.minecraft` (change USER to your computer's name, or if you don't know it, press the `Windows` key and `r` at the same time to open up Run, and type `%appdata%` to open your Roaming folder, then open the `.minecraft` folder). Then open the `skyclient` file if you are using SkyClient. Simply move everything in this folder into the Modrinth App ".minecraft" folder that you opened earlier. Once this is done, you should be able to see all your mods in the Content tab, and can launch the profile. The Content tab can be opened by clicking on the instance (not the green start arrow), and clicking Content on the sidebar. + +When downloading mods from now on, you can simply drag and drop them into the Mods tab in Prism Launcher. Additionally, if the mod is on Modrinth, you can download them within the launcher using the `Add content` button at the top right of the Content tab. + +### Step 5 - Explore + +Modrinth Launcher has a lot of things to offer, such as themes if you don't like the look of it, as well as a lot of options for your instances, including the ability to see all your mods, resource packs, and worlds in the launcher before launching. You can use these menus to install mods and resource packs, and even update mods if they are hosted on Modrinth or CurseForge! Please take the time to actually learn how the launcher works and experiment with it! Prism is an incredibly powerful launcher and it's important to know exactly what you can do with it! + +## Common Issues + +#### `My mods arent showing up in-game!` + +There are 2 common causes for this, open the profile view (click on it or right click then `View instance`), then check the Content tab. If you do not see any mods here, [you should redo step 4](#step-5-installing-our-mods-skyclient). + +If you see a list of mods here then you should click the `Options` tab, then `Edit versions`, then make sure to choose Forge. Click `Save changes` and Forge should be installed, and the mods should work. + +
+ +If you encounter any issues not shown here you should ask for help in my [discord server](https://discord.gg/rejfv9kFJj). + +# Contributors diff --git a/docs/launcher/prism_gnu.md b/docs/launcher/prism_gnu.md index 959ae11b..03b0e49b 100644 --- a/docs/launcher/prism_gnu.md +++ b/docs/launcher/prism_gnu.md @@ -2,11 +2,11 @@ Prism Launcher is an incredibly powerful launcher that makes managing your mods and modded instances much easier. It can do everything the official launcher can do, but allows for much more customization and ease of access. The official launcher has had several issues that have taken weeks to fix or are currently still not fixed, despite their severity. For modded and vanilla users alike, it is recommended to switch to Prism Launcher for an issue-less experience. -This guide will explain the install process for Prism, as well as how we can use it for Skyclient. Please take the time after setting up to better learn your way around the launcher, as you may end up using it as your go-to launcher from now on! +This guide will explain the install process for Prism, as well as how we can use it for SkyClient. Please take the time after setting up to better learn your way around the launcher, as you may end up using it as your go-to launcher from now on! ## How to Install (Linux) -- This is the install guide for GNU/Linux. Despite looking long, this is a very simple process and should only take a few minutes! This guide will also assume you are migrating from Skyclient, but steps will be largely the same, except for the migrating data section. +- This is the install guide for GNU/Linux. Despite looking long, this is a very simple process and should only take a few minutes! This guide will also assume you are migrating from SkyClient, but steps will be largely the same, except for the migrating data section. ### Step 1 - Installing Java @@ -252,9 +252,9 @@ Once you've clicked on the button on the top left that says "Add Instance", name Under the `Version` selector, scroll down till you find 1.8.9 and select it. Then in the `Mod Loader` tab directly underneath, choose Forge (NOTE: this is not the tab on the left that says CurseForge). It will automatically choose the latest version of Forge for 1.8.9 for you. Simply click "OK" to proceed. You should now be back on the main Prism page. -### Step 5 - Installing our mods / Skyclient +### Step 5 - Installing our mods / SkyClient -Now that we've installed Forge 1.8.9, we need to move all our mods to the new Prism Launcher folder. To do that, we'll right click our new instance and press `Edit`. Now, we'll go to the `Mods` tab. On the bottom right, there will be a button called `View Folder`. Click on this and you should be redirected to your file explorer. Now, open a new file explorer and navigate to your old .minecraft folder, which is `~/.minecraft`. Then open the `skyclient` folder if you are using Skyclient. Simply move everything in this folder into the Prism Launcher .minecraft folder that you opened earlier. Once this is done, you should be able to see all your mods in the Mods tab, and can launch the instance. +Now that we've installed Forge 1.8.9, we need to move all our mods to the new Prism Launcher folder. To do that, we'll right click our new instance and press `Folder`. Click on this and you should be redirected to a file explorer window, where you should open the folder titled `.minecraft`. Now, open a new file explorer and navigate to your old .minecraft folder, which is `~/.minecraft`. Then open the `skyclient` folder if you are using SkyClient. Simply move everything in this folder into the Prism Launcher .minecraft folder that you opened earlier. Once this is done, you should be able to see all your mods in the Mods tab, and can launch the instance. When downloading mods from now on, you can simply drag and drop them into the Mods tab in Prism Launcher. Additionally, if the mod is on Modrinth or CurseForge, you can download them within the launcher using the `Download Mods` button. diff --git a/docs/launcher/prism_mac.md b/docs/launcher/prism_mac.md index add55795..a506f7ab 100644 --- a/docs/launcher/prism_mac.md +++ b/docs/launcher/prism_mac.md @@ -2,11 +2,11 @@ Prism Launcher is an incredibly powerful launcher that makes managing your mods and modded instances much easier. It can do everything the official launcher can do, but allows for much more customization and ease of access. The official launcher has had several issues that have taken weeks to fix or are currently still not fixed, despite their severity. For modded and vanilla users alike, it is recommended to switch to Prism Launcher for an issue-less experience. -This guide will explain the install process for Prism, as well as how we can use it for Skyclient. Please take the time after setting up to better learn your way around the launcher, as you may end up using it as your go-to launcher from now on! +This guide will explain the install process for Prism, as well as how we can use it for SkyClient. Please take the time after setting up to better learn your way around the launcher, as you may end up using it as your go-to launcher from now on! ## How to Install (Mac) -- Despite looking long, this is a very simple process and should only take a few minutes! This guide will also assume you are migrating from Skyclient, but steps will be largely the same, except for the migrating data section. +- Despite looking long, this is a very simple process and should only take a few minutes! This guide will also assume you are migrating from SkyClient, but steps will be largely the same, except for the migrating data section. ### Step 1 - Installing Java @@ -64,9 +64,9 @@ Once you've clicked on the button on the top left that says "Add Instance", name Under the `Version` selector, scroll down till you find 1.8.9 and select it. Then in the `Mod Loader` tab directly underneath, choose Forge (NOTE: this is not the tab on the left that says CurseForge). It will automatically choose the latest version of Forge for 1.8.9 for you. Simply click "OK" to proceed. You should now be back on the main Prism page. -### Step 5 - Installing our mods / Skyclient +### Step 5 - Installing our mods / SkyClient -Now that we've installed Forge 1.8.9, we need to move all our mods to the new Prism Launcher folder. To do that, we'll right click our new instance and press `Edit`. Now, we'll go to the `Mods` tab. On the bottom right, there will be a button called `View Folder`. Click on this and you should be redirected to a Finder tab. Now, open a new Finder by either pressing `Cmd + Shift + G` on your keyboard or clicking the Finder tab and pressing "Go". Navigate to your old .minecraft folder by typing `~/Library/Application Support/minecraft`, then open the `skyclient` folder if you are using Skyclient. Simply move everything in this folder into the Prism Launcher .minecraft folder that you opened earlier. Once this is done, you should be able to see all your mods in the Mods tab, and can launch the instance. +Now that we've installed Forge 1.8.9, we need to move all our mods to the new Prism Launcher folder. To do that, we'll right click our new instance and press `Folder`. Click on this and you should be redirected to a Finder window, where you should open the folder titled `.minecraft`. Now, open a new Finder by either pressing `Cmd + Shift + G` on your keyboard or clicking the Finder tab and pressing "Go". Navigate to your old .minecraft folder by typing `~/Library/Application Support/minecraft`, then open the `skyclient` folder if you are using SkyClient. Simply move everything in this folder into the Prism Launcher .minecraft folder that you opened earlier. Once this is done, you should be able to see all your mods in the Mods tab, and can launch the instance. When downloading mods from now on, you can simply drag and drop them into the Mods tab in Prism Launcher. Additionally, if the mod is on Modrinth or CurseForge, you can download them within the launcher using the `Download Mods` button. diff --git a/docs/launcher/prism_win.md b/docs/launcher/prism_win.md index 058e8b27..5a10edf2 100644 --- a/docs/launcher/prism_win.md +++ b/docs/launcher/prism_win.md @@ -2,11 +2,11 @@ Prism Launcher is an incredibly powerful launcher that makes managing your mods and modded instances much easier. It can do everything the official launcher can do, but allows for much more customization and ease of access. The official launcher has had several issues that have taken weeks to fix or are currently still not fixed, despite their severity. For modded and vanilla users alike, it is recommended to switch to Prism Launcher for an issue-less experience. -This guide will explain the install process for Prism, as well as how we can use it for Skyclient. Please take the time after setting up to better learn your way around the launcher, as you may end up using it as your go-to launcher from now on! +This guide will explain the install process for Prism, as well as how we can use it for SkyClient. Please take the time after setting up to better learn your way around the launcher, as you may end up using it as your go-to launcher from now on! ## How to Install (Windows) -- Despite looking long, this is a very simple process and should only take a few minutes! This guide will also assume you are migrating from Skyclient, but steps will be largely the same, except for the migrating data section. +- Despite looking long, this is a very simple process and should only take a few minutes! This guide will also assume you are migrating from SkyClient, but steps will be largely the same, except for the migrating data section. ### Step 1 - Installing Java @@ -25,7 +25,7 @@ Once we have chosen our download preferences, we will click the `.msi` download ### Step 2 - Installing Prism -[Download Prism Launcher](https://prismlauncher.org/download). You will most likely want to download the `Installer (.exe)` version. Once it is finished downloading, it may give a warning screen saying "Windows protected your PC". Simply press the "More info" button, then "Run anyway" +[Download Prism Launcher](https://prismlauncher.org/download). You will most likely want to download the `Installer (.exe)` version. Once it is finished downloading, it may give a warning screen saying "Windows protected your PC". Simply press the "More info" button, then "Run anyway". Continue the installation process until you get to the "Java" screen. Here, you will decide which Java you want to set as the default for new instances. Click on the version that says "1.8" at the beginning of the version and has "Eclipse Foundation" in the path name. This is your Java 8 and it will be the default version of Java for every new instance you create on Prism. Of course, you can always change this later and can still manually specify a different version of Java whenever you want. @@ -49,9 +49,9 @@ Once you've clicked on the button on the top left that says "Add Instance", name Under the `Version` selector, scroll down till you find 1.8.9 and select it. Then in the `Mod Loader` tab directly underneath, choose Forge (NOTE: this is not the tab on the left that says CurseForge). It will automatically choose the latest version of Forge for 1.8.9 for you. Simply click "OK" to proceed. You should now be back on the main Prism page. -### Step 5 - Installing our mods / Skyclient +### Step 5 - Installing our mods / SkyClient -Now that we've installed Forge 1.8.9, we need to move all our mods to the new Prism Launcher folder. To do that, we'll right click our new instance and press `Edit`. Now, we'll go to the `Mods` tab. On the bottom right, there will be a button called `View Folder`. Click on this and you should be redirected to a File Explorer tab. Now, open a new File Explorer by either pressing `Win + E` on your keyboard or right clicking the file explorer icon and pressing "File Explorer". Navigate to your old .minecraft folder, which is `C:\Users\USER\AppData\Roaming\.minecraft` (change USER to your computer's name, or if you don't know it, press the `Windows` key and `r` at the same time to open up Run, and type `%appdata%` to open your Roaming folder, then open the `.minecraft` folder). Then open the `skyclient` file if you are using Skyclient. Simply move everything in this folder into the Prism Launcher .minecraft folder that you opened earlier. Once this is done, you should be able to see all your mods in the Mods tab, and can launch the instance. +Now that we've installed Forge 1.8.9, we need to move all our mods to the new Prism Launcher folder. To do that, we'll right click our new instance and press `Folder`. Click on this and you should be redirected to a File Explorer window, where you should open the folder titled `.minecraft`. Now, open a new File Explorer by either pressing `Win + E` on your keyboard or right clicking the file explorer icon and pressing "File Explorer". Navigate to your old .minecraft folder, which is `C:\Users\USER\AppData\Roaming\.minecraft` (change USER to your computer's name, or if you don't know it, press the `Windows` key and `r` at the same time to open up Run, and type `%appdata%` to open your Roaming folder, then open the `.minecraft` folder). Then open the `skyclient` file if you are using SkyClient. Simply move everything in this folder into the Prism Launcher .minecraft folder that you opened earlier. Once this is done, you should be able to see all your mods in the Mods tab, and can launch the instance. [A quick video guide explaining this process can be found here.](https://youtu.be/DEGaD-_HFCE) @@ -67,7 +67,7 @@ You can find a list of Prism themes and how to install them on [their website](h Automatic updating has been added since Prism Launcher 8.0. Simply press the `Update` button in the top toolbar to check for updates. -If you are on a version less than 8.0, you will need to download the installer and run it again (you will not lose your instances/your Skyclient). +If you are on a version less than 8.0, you will need to download the installer and run it again (you will not lose your instances/your SkyClient). In some cases (specifically when you are on version 5.x or lower), you may need to uninstall your current Prism Launcher entirely before reinstalling. Your instances will still be safe and will not be deleted. diff --git a/mkdocs.yml b/mkdocs.yml index 56ee1686..f6e27c22 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -82,6 +82,8 @@ nav: - "Migrating to Latest": "latest/migrating.md" - "Launcher": - "Home": "launcher/home.md" + - "Modrinth App": + - "Windows": "launcher/modrinth_win.md" - "Prism Launcher": - "Windows": "launcher/prism_win.md" - "MacOS": "launcher/prism_mac.md"