Fabulously-Optimized · its-miroma · Jan 16, 2025 · Jan 19, 2025 · Jun 1, 2025
diff --git a/how-to/README.md 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
@@ -0,0 +1,30 @@
+---
+hidden: true
+icon: arrows-rotate
+---
+
+# Update
+
+<table data-view="cards"><thead><tr><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Modrinth App</strong></td><td><a href="modrinth-app.md">modrinth-app.md</a></td></tr><tr><td align="center"><strong>CurseForge App</strong></td><td><a href="curseforge-app.md">curseforge-app.md</a></td></tr><tr><td align="center"><strong>Prism Launcher</strong></td><td><a href="prism-launcher.md">prism-launcher.md</a></td></tr><tr><td align="center"><strong>Minecraft Launcher</strong></td><td><a href="vanilla.md">vanilla.md</a></td></tr><tr><td align="center"><strong>MultiMC</strong></td><td><a href="multimc.md">multimc.md</a></td></tr></tbody></table>
+
+{% 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. 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 %}
+
+{% 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
@@ -0,0 +1,26 @@
+---
+hidden: true
+---
+
+# 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 <kbd>**Minecraft**</kbd> from the grid or from the sidebar
+3. In **My Modpacks**, right-click on <kbd>**Fabulously Optimized**</kbd>
+4. Click on the <kbd>**Change Version**</kbd> button
+5. If you cannot find the <kbd>**Change Version**</kbd> button, it means you've added custom mods:
+   1. Click on the <kbd>**three dots**</kbd> button
+   2. Click on <kbd>**Profile Options**</kbd>
+   3. Uncheck the <kbd>**Allow content management for this profile**</kbd> checkbox
+   4. Click on <kbd>**Continue**</kbd>
+6. If you do not want the latest version, select the version you want from the dropdown
+7. Click on <kbd>**Continue**</kbd>. FO should now get updated
+8. If you've followed _step 5_, remember to check the <kbd>**Allow content management for this profile**</kbd> checkbox again
+9. Once updated, click on <kbd>**Play**</kbd> 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
@@ -0,0 +1,27 @@
+---
+hidden: true
+---
+
+# 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 <kbd>**Library**</kbd> section
+3. Select the existing **Fabulously Optimized** instance
+4. Click on the <kbd>**Update modpack**</kbd> 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 <kbd>**two-arrows**</kbd> 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!
+
+<details>
+<summary>Clear cache instructions</summary>
+
+TODO
+
+</details>
diff --git a/how-to/update/multimc.md b/how-to/update/multimc.md
@@ -0,0 +1,34 @@
+---
+hidden: true
+---
+
+# 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 <kbd>**This modpack uses new versions of the following...**</kbd>, click on the <kbd>**Update**</kbd> 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 <kbd>**Minecraft Folder**</kbd>
+4. Click on the new version as well
+5. Click on <kbd>**Minecraft Folder**</kbd>
+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 **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
@@ -0,0 +1,21 @@
+---
+hidden: true
+---
+
+# 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 <kbd>**Fabulously Optimized**</kbd> instance
+3. Click on <kbd>**Edit**</kbd> in the sidebar
+4. Select <kbd>**Modrinth**</kbd> 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 <kbd>**Update pack**</kbd> button. A prompt should pop up
+7. Click on <kbd>**Yes**</kbd>. 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!
diff --git a/how-to/update/vanilla.md b/how-to/update/vanilla.md
@@ -0,0 +1,26 @@
+---
+hidden: true
+---
+
+# 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 %}