From 6dd92f0f1cf1ec81d6713671b923ddfe498cef1d Mon Sep 17 00:00:00 2001 From: Miroma <136986257+its-miroma@users.noreply.github.com> Date: Thu, 16 Jan 2025 16:16:27 +0100 Subject: [PATCH 1/3] rewrite(how-to/update): initial commit --- how-to/README.md | 6 ++++++ how-to/update/README.md | 30 +++++++++++++++++++++++++++++ how-to/update/curseforge-app.md | 26 +++++++++++++++++++++++++ how-to/update/modrinth-app.md | 22 +++++++++++++++++++++ how-to/update/multimc.md | 34 +++++++++++++++++++++++++++++++++ how-to/update/prism-launcher.md | 21 ++++++++++++++++++++ how-to/update/vanilla.md | 26 +++++++++++++++++++++++++ 7 files changed, 165 insertions(+) create mode 100644 how-to/README.md create mode 100644 how-to/update/README.md create mode 100644 how-to/update/curseforge-app.md create mode 100644 how-to/update/modrinth-app.md create mode 100644 how-to/update/multimc.md create mode 100644 how-to/update/prism-launcher.md create mode 100644 how-to/update/vanilla.md diff --git a/how-to/README.md b/how-to/README.md new file mode 100644 index 00000000..efe376f9 --- /dev/null +++ b/how-to/README.md @@ -0,0 +1,6 @@ +--- +hidden: true +icon: arrow-progress +--- + +# How to... diff --git a/how-to/update/README.md b/how-to/update/README.md new file mode 100644 index 00000000..c0b78dd8 --- /dev/null +++ b/how-to/update/README.md @@ -0,0 +1,30 @@ +--- +hidden: true +icon: arrows-rotate +--- + +# Update + +
Modrinth Appmodrinth-app.md
CurseForge Appcurseforge-app.md
Prism Launcherprism-launcher.md
Minecraft Launchervanilla.md
MultiMCmultimc.md
+ +{% hint style="danger" %} +**You should ALWAYS** [**make backups**](../backup/) **before updating**. + +As with any other piece of software, updates may go wrong for many reasons, including but not limited to: the launcher, the hardware, your custom configuration, the mods you added... and, rarely, FO as well. +{% endhint %} + +{% hint style="warning" %} +**FO only supports updates to stable versions**. + +We do NOT support updating from a stable to an unstable version, nor do we support downgrading. In those cases, consider creating a separate installation/instance. + +Of course, if you've [added custom mods to FO](../add-mods/), you are responsible for updating those, but you should not update [mods bundled in FO](../../info/mods/) manually. +{% endhint %} + +{% hint style="info" %} +If you want the recommended FO configuration after an update, you may [reset your custom settings](../../info/options/reset/). +{% endhint %} + +{% hint style="info" %} +If a server you're playing on is out-of-date, you may want to [add](../add-mods/) the [ViaFabricPlus mod](https://modrinth.com/mod/viafabricplus). +{% endhint %} diff --git a/how-to/update/curseforge-app.md b/how-to/update/curseforge-app.md new file mode 100644 index 00000000..4e6ddf44 --- /dev/null +++ b/how-to/update/curseforge-app.md @@ -0,0 +1,26 @@ +--- +hidden: true +--- + +# How to Update: CurseForge App + +{% hint style="danger" %} +**You should ALWAYS [make backups](../backup/curseforge-app.md) before updating**. + +As with any other piece of software, updates may go wrong for many reasons, including but not limited to: the launcher, the hardware, your custom configuration, the mods you added... and, rarely, FO as well. +{% endhint %} + +1. Open the **CurseForge App** +2. Select **Minecraft** from the grid or from the sidebar +3. In **My Modpacks**, right-click on **Fabulously Optimized** +4. Click on the **Change Version** button +5. If you cannot find the **Change Version** button, it means you've added custom mods: + 1. Click on the three dots button + 2. Click on **Profile Options** + 3. Uncheck the **Allow content management for this profile** checkbox + 4. Click on **Continue** +6. If you do not want the latest version, select the version you want from the dropdown +7. Click on **Continue**. FO should now get updated +8. If you've followed _step 5_, remember to check the **Allow content management for this profile** checkbox again +9. Once updated, launch the instance. Minecraft should open up +10. If you can see the newly installed version in the bottom-right corner, you're done! diff --git a/how-to/update/modrinth-app.md b/how-to/update/modrinth-app.md new file mode 100644 index 00000000..e3fd86a2 --- /dev/null +++ b/how-to/update/modrinth-app.md @@ -0,0 +1,22 @@ +--- +hidden: true +--- + +# How to Update: Modrinth App + +{% hint style="danger" %} +**You should ALWAYS [make backups](../backup/modrinth-app.md) before updating**. + +As with any other piece of software, updates may go wrong for many reasons, including but not limited to: the launcher, the hardware, your custom configuration, the mods you added... and, rarely, FO as well. +{% endhint %} + +1. Open the **Modrinth App** +2. Click on the **Library** section +3. Select the existing FO instance +4. Click on the **Update modpack** button on the top-right +5. If you do not want the latest version, select the version you want from the dropdown +6. Click on the **two-arrows** button. FO should get updated +7. Once updated, launch the instance. Minecraft should open up +8. If you can see the newly installed version in the bottom-right corner, you're done! + + diff --git a/how-to/update/multimc.md b/how-to/update/multimc.md new file mode 100644 index 00000000..bb50d7b9 --- /dev/null +++ b/how-to/update/multimc.md @@ -0,0 +1,34 @@ +--- +hidden: true +--- + +# How to Update: MultiMC + +{% hint style="danger" %} +**You should ALWAYS [make backups](../backup/multimc.md) before updating**. + +As with any other piece of software, updates may go wrong for many reasons, including but not limited to: the launcher, the hardware, your custom configuration, the mods you added... and, rarely, FO as well. +{% endhint %} + +{% hint style="success" %} +If you had installed [FO on MultiMC **with** automatic updates](../install/multimc.md#automatic-updates), and you're not updating to a newer version of Minecraft, you just need to open the existing versions. + +If you get a popup saying **This modpack uses new versions of the following...**, click on the **Update** button. +{% endhint %} + +If you had installed [FO on MultiMC **without** automatic updates](../install/multimc.md#easier-installation), or if you're updating to a new version of Minecraft: + +1. Follow the [FO installation instructions for MultiMC](../install/multimc.md) again. This will create a new instance +2. In **MultiMC**, click on the previous version +3. Click on **Minecraft Folder** +4. Click on the new version as well +5. Click on **Minecraft Folder** +6. Copy the following files from the folder you opened in _step 3_ to the folder you opened in _step 5_: + * `saves`: Your local worlds + * `resourcepacks`: Your resource packs, if any. If you're asked to replace files, do not! + * `shaders`: Your shaders, if any + * `screenshots`: Your screenshots, if any + * `server.dat`: Your multiplayer servers, if any + * `options.txt`: Your custom options and keybinds, if any. If you want the [recommended FO settings](../info/options.md), do not copy it +7. Once you've moved them, launch the new instance. Minecraft should open up +8. If you can see the newly installed version in the bottom-right corner, you can delete the previous version from _step 2_ diff --git a/how-to/update/prism-launcher.md b/how-to/update/prism-launcher.md new file mode 100644 index 00000000..7ae43d27 --- /dev/null +++ b/how-to/update/prism-launcher.md @@ -0,0 +1,21 @@ +--- +hidden: true +--- + +# How to Update: Prism Launcher + +{% hint style="danger" %} +**You should ALWAYS [make backups](../backup/prism-launcher.md) before updating**. + +As with any other piece of software, updates may go wrong for many reasons, including but not limited to: the launcher, the hardware, your custom configuration, the mods you added... and, rarely, FO as well. +{% endhint %} + +1. Open the **Prism Launcher** +2. Select the existing FO instance +3. Click on **Edit** in the sidebar +4. Select **Modrinth** in the tab list +5. If you do not want the latest version, select the version you want from the dropdown +6. Click on the **Update pack** button. A prompt should pop up +7. Click on **Yes**. FO should get updated +8. Once updated, launch the instance. Minecraft should open up +9. If you can see the newly installed version in the bottom-right corner, you're done! diff --git a/how-to/update/vanilla.md b/how-to/update/vanilla.md new file mode 100644 index 00000000..e440a964 --- /dev/null +++ b/how-to/update/vanilla.md @@ -0,0 +1,26 @@ +--- +hidden: true +--- + +# How to Update: Minecraft Launcher + +{% hint style="danger" %} +**You should ALWAYS [make backups](../backup/vanilla.md) before updating**. + +As with any other piece of software, updates may go wrong for many reasons, including but not limited to: the launcher, the hardware, your custom configuration, the mods you added... and, rarely, FO as well. +{% endhint %} + +{% tabs %} +{% tab title="Installer" %} + +Follow the [installation instructions](../install/vanilla.md) again. + +You may find a `paigaldaja_meta.json` file in the same folder as the installer. Don't worry: this is just a configuration file for smoother future updates. +{% endtab %} + +{% tab title="Manual" %} +If you've installed FO manually, you must reinstall it for every update. + +Follow the [installation instructions](../install/vanilla.md) again. You may skip _step 1_ because Java is already installed. +{% endtab %} +{% endtabs %} From c888ac2eb5c542c1fe1a1948770e6e6c1a3c4470 Mon Sep 17 00:00:00 2001 From: Miroma <136986257+its-miroma@users.noreply.github.com> Date: Sun, 19 Jan 2025 15:46:12 +0100 Subject: [PATCH 2/3] rewrite(how-to/update): fix headings --- how-to/update/curseforge-app.md | 2 +- how-to/update/modrinth-app.md | 2 +- how-to/update/multimc.md | 2 +- how-to/update/prism-launcher.md | 2 +- how-to/update/vanilla.md | 2 +- 5 files changed, 5 insertions(+), 5 deletions(-) diff --git a/how-to/update/curseforge-app.md b/how-to/update/curseforge-app.md index 4e6ddf44..e92dae8d 100644 --- a/how-to/update/curseforge-app.md +++ b/how-to/update/curseforge-app.md @@ -2,7 +2,7 @@ hidden: true --- -# How to Update: CurseForge App +# CurseForge App {% hint style="danger" %} **You should ALWAYS [make backups](../backup/curseforge-app.md) before updating**. diff --git a/how-to/update/modrinth-app.md b/how-to/update/modrinth-app.md index e3fd86a2..b187d7e8 100644 --- a/how-to/update/modrinth-app.md +++ b/how-to/update/modrinth-app.md @@ -2,7 +2,7 @@ hidden: true --- -# How to Update: Modrinth App +# Modrinth App {% hint style="danger" %} **You should ALWAYS [make backups](../backup/modrinth-app.md) before updating**. diff --git a/how-to/update/multimc.md b/how-to/update/multimc.md index bb50d7b9..feb2b52e 100644 --- a/how-to/update/multimc.md +++ b/how-to/update/multimc.md @@ -2,7 +2,7 @@ hidden: true --- -# How to Update: MultiMC +# MultiMC {% hint style="danger" %} **You should ALWAYS [make backups](../backup/multimc.md) before updating**. diff --git a/how-to/update/prism-launcher.md b/how-to/update/prism-launcher.md index 7ae43d27..36a0dff5 100644 --- a/how-to/update/prism-launcher.md +++ b/how-to/update/prism-launcher.md @@ -2,7 +2,7 @@ hidden: true --- -# How to Update: Prism Launcher +# Prism Launcher {% hint style="danger" %} **You should ALWAYS [make backups](../backup/prism-launcher.md) before updating**. diff --git a/how-to/update/vanilla.md b/how-to/update/vanilla.md index e440a964..83a85ebe 100644 --- a/how-to/update/vanilla.md +++ b/how-to/update/vanilla.md @@ -2,7 +2,7 @@ hidden: true --- -# How to Update: Minecraft Launcher +# Minecraft Launcher {% hint style="danger" %} **You should ALWAYS [make backups](../backup/vanilla.md) before updating**. From c3961e64d53f18686d6aa33428f8faddfb0d501e Mon Sep 17 00:00:00 2001 From: Miroma <136986257+its-miroma@users.noreply.github.com> Date: Sun, 1 Jun 2025 15:11:29 +0200 Subject: [PATCH 3/3] rewrite(how-to/update): use `kbd` for UI buttons --- how-to/update/README.md | 2 +- how-to/update/curseforge-app.md | 22 +++++++++++----------- how-to/update/modrinth-app.md | 17 +++++++++++------ how-to/update/multimc.md | 8 ++++---- how-to/update/prism-launcher.md | 12 ++++++------ 5 files changed, 33 insertions(+), 28 deletions(-) diff --git a/how-to/update/README.md b/how-to/update/README.md index c0b78dd8..74f03c01 100644 --- a/how-to/update/README.md +++ b/how-to/update/README.md @@ -16,7 +16,7 @@ As with any other piece of software, updates may go wrong for many reasons, incl {% hint style="warning" %} **FO only supports updates to stable versions**. -We do NOT support updating from a stable to an unstable version, nor do we support downgrading. In those cases, consider creating a separate installation/instance. +We do NOT support updating from a stable to an unstable version, nor do we support downgrading. In those cases, consider creating a separate installation/instance. Read more about [FO's versioning](../../about/versioning.md). Of course, if you've [added custom mods to FO](../add-mods/), you are responsible for updating those, but you should not update [mods bundled in FO](../../info/mods/) manually. {% endhint %} diff --git a/how-to/update/curseforge-app.md b/how-to/update/curseforge-app.md index e92dae8d..05d96a04 100644 --- a/how-to/update/curseforge-app.md +++ b/how-to/update/curseforge-app.md @@ -11,16 +11,16 @@ As with any other piece of software, updates may go wrong for many reasons, incl {% endhint %} 1. Open the **CurseForge App** -2. Select **Minecraft** from the grid or from the sidebar -3. In **My Modpacks**, right-click on **Fabulously Optimized** -4. Click on the **Change Version** button -5. If you cannot find the **Change Version** button, it means you've added custom mods: - 1. Click on the three dots button - 2. Click on **Profile Options** - 3. Uncheck the **Allow content management for this profile** checkbox - 4. Click on **Continue** +2. Select **Minecraft** from the grid or from the sidebar +3. In **My Modpacks**, right-click on **Fabulously Optimized** +4. Click on the **Change Version** button +5. If you cannot find the **Change Version** button, it means you've added custom mods: + 1. Click on the **three dots** button + 2. Click on **Profile Options** + 3. Uncheck the **Allow content management for this profile** checkbox + 4. Click on **Continue** 6. If you do not want the latest version, select the version you want from the dropdown -7. Click on **Continue**. FO should now get updated -8. If you've followed _step 5_, remember to check the **Allow content management for this profile** checkbox again -9. Once updated, launch the instance. Minecraft should open up +7. Click on **Continue**. FO should now get updated +8. If you've followed _step 5_, remember to check the **Allow content management for this profile** checkbox again +9. Once updated, click on **Play** to launch the instance. Minecraft should open up 10. If you can see the newly installed version in the bottom-right corner, you're done! diff --git a/how-to/update/modrinth-app.md b/how-to/update/modrinth-app.md index b187d7e8..70352b49 100644 --- a/how-to/update/modrinth-app.md +++ b/how-to/update/modrinth-app.md @@ -11,12 +11,17 @@ As with any other piece of software, updates may go wrong for many reasons, incl {% endhint %} 1. Open the **Modrinth App** -2. Click on the **Library** section -3. Select the existing FO instance -4. Click on the **Update modpack** button on the top-right +2. Click on the **Library** section +3. Select the existing **Fabulously Optimized** instance +4. Click on the **Update modpack** button on the top-right 5. If you do not want the latest version, select the version you want from the dropdown -6. Click on the **two-arrows** button. FO should get updated -7. Once updated, launch the instance. Minecraft should open up +6. Click on the **two-arrows** button. FO should get updated +7. Once updated, launch **Fabulously Optimized**. Minecraft should open up 8. If you can see the newly installed version in the bottom-right corner, you're done! - +
+Clear cache instructions + +TODO + +
diff --git a/how-to/update/multimc.md b/how-to/update/multimc.md index feb2b52e..2499e596 100644 --- a/how-to/update/multimc.md +++ b/how-to/update/multimc.md @@ -13,16 +13,16 @@ As with any other piece of software, updates may go wrong for many reasons, incl {% hint style="success" %} If you had installed [FO on MultiMC **with** automatic updates](../install/multimc.md#automatic-updates), and you're not updating to a newer version of Minecraft, you just need to open the existing versions. -If you get a popup saying **This modpack uses new versions of the following...**, click on the **Update** button. +If you get a popup saying **This modpack uses new versions of the following...**, click on the **Update** button. {% endhint %} If you had installed [FO on MultiMC **without** automatic updates](../install/multimc.md#easier-installation), or if you're updating to a new version of Minecraft: 1. Follow the [FO installation instructions for MultiMC](../install/multimc.md) again. This will create a new instance 2. In **MultiMC**, click on the previous version -3. Click on **Minecraft Folder** +3. Click on **Minecraft Folder** 4. Click on the new version as well -5. Click on **Minecraft Folder** +5. Click on **Minecraft Folder** 6. Copy the following files from the folder you opened in _step 3_ to the folder you opened in _step 5_: * `saves`: Your local worlds * `resourcepacks`: Your resource packs, if any. If you're asked to replace files, do not! @@ -30,5 +30,5 @@ If you had installed [FO on MultiMC **without** automatic updates](../install/mu * `screenshots`: Your screenshots, if any * `server.dat`: Your multiplayer servers, if any * `options.txt`: Your custom options and keybinds, if any. If you want the [recommended FO settings](../info/options.md), do not copy it -7. Once you've moved them, launch the new instance. Minecraft should open up +7. Once you've moved them, launch **Fabulously Optimized**. Minecraft should open up 8. If you can see the newly installed version in the bottom-right corner, you can delete the previous version from _step 2_ diff --git a/how-to/update/prism-launcher.md b/how-to/update/prism-launcher.md index 36a0dff5..707d0a9c 100644 --- a/how-to/update/prism-launcher.md +++ b/how-to/update/prism-launcher.md @@ -11,11 +11,11 @@ As with any other piece of software, updates may go wrong for many reasons, incl {% endhint %} 1. Open the **Prism Launcher** -2. Select the existing FO instance -3. Click on **Edit** in the sidebar -4. Select **Modrinth** in the tab list +2. Select the existing **Fabulously Optimized** instance +3. Click on **Edit** in the sidebar +4. Select **Modrinth** in the tab list 5. If you do not want the latest version, select the version you want from the dropdown -6. Click on the **Update pack** button. A prompt should pop up -7. Click on **Yes**. FO should get updated -8. Once updated, launch the instance. Minecraft should open up +6. Click on the **Update pack** button. A prompt should pop up +7. Click on **Yes**. FO should get updated +8. Once updated, launch **Fabulously Optimized**. Minecraft should open up 9. If you can see the newly installed version in the bottom-right corner, you're done!