# How to update FO
### Notes
* As with any update, *things may break*. Probably not due to the modpack itself, but maybe your launcher, your added mods or your hard drive. Backups are recommended.
* If you follow these instructions, your added mods and most modpack mods' settings will persist. If you want, you can [reset your settings](#resetting-options) to get the latest modpack configurations.
* Always update the modpack first and then your own mods (if any). Do not update the modpack's mods manually, unless it is a legacy version and you know what you're doing.
### CurseForge App
#### If you haven't changed modpack's mods
1. Select *Minecraft* from the grid or sidebar
2. On the "My Modpacks" tab, right click *Fabulously Optimized*, then `⇄ Change Version`
* Don't see that option? Follow the other instructions below.
3. Click `Select version`
4. Select a version that matches your current or has a newer Minecraft version
* Do not select an older version, this could corrupt your worlds and settings!
* Do not update to an alpha or beta from a release version, [install a separate instance](https://wiki.download.fo/install-instructions#curseforge-app) for testing.
5. Click `Continue`. Modpack will now update.
6. Run it and check the version difference in the bottom right corner.
#### If you've added or removed some mods
1. Select *Minecraft* from the grid or sidebar
2. On the "My Modpacks" tab, click *Fabulously Optimized*
3. Click `⫶`→ `Profile Options`
4. Uncheck "Allow content management for this profile".
* This will not affect added content and you can re-enable content management after the update.
5. Click `Done`
6. Click `⇄` (between `⫶` and `Play`).
7. Click `Select version`
8. Select a version that matches your current or has a newer Minecraft version
* Do not select an older version, this could corrupt your worlds and settings!
* Do not update to an alpha or beta from a release version, [install a separate instance](https://wiki.download.fo/install-instructions#curseforge-app) for testing.
9. Click `Continue`. The modpack will now update.
10. Run it and check the version difference in the bottom right corner.
### Modrinth App
#### If the update uses the same Minecraft version
1. Go to `|||\` "Library"
2. Select existing Fabulously Optimized instance
3. Click `⤓ Update` on top right (next to `ஃ Content`)
4. Click `⤓ Update to ...`
* Do not select an older version, this could corrupt your worlds and settings!
* Do not update to an alpha or beta from a release version, [install a separate instance](https://wiki.download.fo/install-instructions#modrinth-app) for testing.
5. In the warning, click `⤓ Update modpack`
6. Run it and check the version difference in the bottom right corner.
#### If the update uses a newer Minecraft version
{% hint style="warning" %}
Do not update to an alpha or beta from a release version, make a separate instance for testing.
{% endhint %}
1. Go to `|||\` "Library"
2. Select existing Fabulously Optimized instance
3. Click `⚙️` on top right (next to `ஃ Content`)
4. Click `⇆ Change version` below Installed modpack
5. Click `👁️ Show incompatible`
6. Select the latest version and click `⤓ Update to ...`
* Do not select an older version, this could corrupt your worlds and settings!
* Do not update to an alpha or beta from a release version, [install a separate instance](https://wiki.download.fo/install-instructions#modrinth-app) for testing.
7. In the warning, click `⤓ Update modpack`
8. Run it and check the version difference in the bottom right corner.
### Prism Launcher
1. Select existing Fabulously Optimized instance
2. Click `Edit` on the sidebar
3. Select `Modrinth` on the tab list
4. Click on the version dropdown
5. Select the version that matches your current or has a newer Minecraft version
* Do not select an older version, this could corrupt your worlds and settings!
* Do not update to an alpha or beta from a release version, [install a separate instance](https://wiki.download.fo/install-instructions#prism-launcher) for testing.
6. Click `Update pack`. Modpack will now update.
* If a prompt is asking to change the instance name, click `Yes`
7. Run it and check the version difference in the bottom right corner.
### MultiMC
{% hint style="info" %}
Seems tedious? Consider switching to Prism Launcher or using the MultiMC (auto-update) variant instead.
{% endhint %}
1. Click `Add Instance`
2. Select `Modrinth` tab from the left
3. Select "Fabulously Optimized"
4. Click on the version dropdown
5. Select the version that matches your current or has a newer Minecraft version
* Do not select an older version, this could corrupt your worlds and settings!
* Do not update to an alpha or beta from a release version, [install a separate instance](https://wiki.download.fo/install-instructions#multimc) for testing.
6. Click `OK`. The modpack will now install.
7. Click that version you just created, then `Minecraft Folder`
8. Click the previous version, then `Minecraft Folder`
9. Copy the important files and folders over:
* `saves` - your local worlds
* `resourcepacks` - if you added any (it is not needed to copy [the modpack defaults](https://wiki.download.fo/changed-options#resource-packs))
* `shaders` - if you use any
* `screenshots` - screenshots you've taken with F2 or F9
* `servers.dat` - your multiplayer servers
* `options.txt` - if you want to keep your vanilla option and all hotkey changes
* Ignore the `Copy all 3 folders!` file, that's for vanilla launcher users
10. Close the folders and run the new version
11. If everything looks right, delete the old version
### MultiMC (auto-update)
#### If the update uses the same Minecraft version
1. Run the existing version, wait for the progress bar to fill up
* If you get a popup "This modpack uses new versions of the following...", just click `Update`.
2. Check the version difference in the bottom right corner.
#### If the update uses a newer Minecraft version
1. Go to the existing instance, click `Edit Instance`
2. Go to `Settings` on the left, then `Custom commands`
3. On `Pre-launch command`, you see a long text. Scroll to the rightmost edge.
4. It will say something like *.../main/Packwiz/**1.21.11**/pack.toml*. Change the Minecraft version to a newer one.
* Do not select an older version, this could corrupt your worlds and settings!
* [Ensure that the modpack is already built for that version](https://modrinth.com/modpack/fabulously-optimized/versions).
5. Click `Launch`.
6. You should see a popup saying "This modpack uses newer versions of the following..." - click `Update`.
7. You're done - the instance is now using an updated Minecraft version.
Got asked to download a mod manually?
If you get asked to download a specific jar, it means we are not allowed to bundle it and you must add it manually:
1. Copy and paste the given address to your browser
2. Click `Cancel Launch`
3. Click `Download` on the mod
4. On MultiMC, click on the instance, then click `View Mods`
5. Drag the downloaded mod into the mod list
6. Click `Launch`
### Minecraft Launcher (vanilla)
1. Download [Fabulously Optimized Installer](https://download.fo/vanilla) and run it
* In most cases, you may also use the older version of the installer if you have it already.
* Windows: Open the .exe file, click `More info` and then `Run anyway`.
* macOS: See instructions below
* Linux: Open the .appimage file and click `Run once` when prompted.
2. Select preferred FO/Minecraft version and install
3. Run Minecraft Launcher. You'll see the new installation, click PLAY.
Note: you may now see a new file *paigaldaja\_meta.json* next to the installer. This is a configuration file that ensures smoother upgrades and remembers some of your install settings.
MacOS installer opening instructions
**macOS Sequoia 15 and later**
1. Open the downloaded .dmg file
2. Double-click the "Fabulously Optimized Installer". You will get a warning, press `Done`.
3. On your menubar, press Apple logo, then `System Settings`, then click `Privacy & Security` in the sidebar
4. Scroll down on the right view, you should see the button `Open anyway`
5. Enter your password or fingerprint. The installer should open.
6. Future launches of the same installer version open the installer directly on double-click.
**macOS Sonoma 14 and older**
1. Open the downloaded .dmg file
2. **Right click** the "Fabulously Optimized Installer" and click `Open`
3. Click `Open` again when asked in a prompt. The installer should open.
4. Future launches of the same installer version open the installer directly on double-click.
**Why is this necessary?**
Apple requires 99$ a year to get a program "verified". This is not feasible for this modpack. If you are concerned, feel free to use manual instructions or a different launcher.
Manual installation - Minecraft 1.19.4+
1. Download and install [Fabric Loader](https://fabricmc.net/use/) **version 0.18.4**
* Remember that the *installer version* doesn't matter, what matters is the *loader version* that appears when you run the installer.
2. Open Minecraft Launcher, click `Installations`, then click 📂 on the Fabric installation
3. [Open this site](https://download.fo/vanilla), then click the ⬇️ button
* Optional: Select the version you want by selecting it on the dropdown before you click ⬇️.
* Do not select an older version, this could corrupt your worlds and settings!
* Do not update to an alpha or beta from a release version, [create it to a separate instance](https://help.minecraft.net/hc/en-us/articles/23431114561037-Create-a-New-Minecraft-Java-Installation-to-Troubleshoot-Launcher-Crashes) for testing.
* If you got a prompt for popup windows or multiple downloads, please accept it - technical limitation.
4. Open the zip file and copy **all folders** to your *.minecraft* folder
* If asked - replace the files.
5. Recommended: delete current `options.txt` to get [modpack's default settings](https://wiki.download.fo/changed-options)
* Your vanilla options like selected resource packs, language, keybinds will be reset but you can reapply them later.
6. Launch the installed Fabric profile
7. If you now see "Fabulously Optimized" in the right bottom corner, you're done!
Manual installation - Minecraft 1.16.1-1.19.3
1. Download and install [Fabric Loader](https://fabricmc.net/use/)
* Minecraft 1.19-1.19.3: Fabric Loader **0.14.24** and [Java 17](https://download.fo/java17)
* Minecraft 1.17-1.18.2: Fabric Loader **0.14.12** and [Java 17](https://download.fo/java17)
* Minecraft 1.16.5: Fabric Loader **0.13.3** and [Java 8](https://download.fo/java8)
* Remember that the *installer version* doesn't matter, what matters is the *loader version* that appears when you run the installer.
2. Open Minecraft Launcher, click `Installations`, then click 📂 on the Fabric installation
3. Go to [Files](https://www.curseforge.com/minecraft/modpacks/fabulously-optimized/files?showAlphaFiles=show) on CurseForge
4. Click the version you need, then click "Additional files"
* Never downgrade an instance, this could corrupt your worlds and settings!
* It is not advised to upgrade release → alpha or release → beta, make a separate instance for testing.
* Updating alpha → beta or beta → release is recommended as long as the Minecraft version matches.
5. Click `⋮` → `Download file` on the latest **MultiMC version**
* If you see less than 10 mods in the zip, you downloaded the wrong version.
6. Open the zip file, go to *Fabulously Optimized x.x.x* > *minecraft*
7. Open the zip file and copy **all folders** from zip's *minecraft* folder to your *.minecraft* folder
* If asked - replace the files.
8. Recommended: delete current `options.txt` to get [modpack's default settings](https://wiki.download.fo/changed-options)
* Your vanilla options like selected resource packs, language, keybinds will be reset but you can reapply them later.
9. Launch the installed Fabric profile
10. If you now see "Fabulously Optimized" in the right bottom corner, you're done!
### GDLauncher
No longer supported. [Please migrate to Prism Launcher.](https://wiki.download.fo/install-instructions#gdlauncher)
## Resetting options
Because the pack is using Config Manager or YOSBR, your vanilla options and most of the mod ones will not change when you upgrade, [despite what is stated in the changelog](https://github.com/Fabulously-Optimized/fabulously-optimized/blob/main/CHANGELOG.md). This is made so that you can upgrade without having to reconfigure your options all the time.
However, at some point you may still want to do that in order to get the latest changes.
1. Launch the game
2. Go to `Mods` -> `Config Manager` -> `🎛️`
3. If you want to *apply latest changes* but keep configs for added mods, select `Update modpack's configs`. If you want to *delete all configs* and start fresh, select `Reset modpack's configs`.
4. Close the game and start it again. See if it works.
5. If you got an error (especially on alpha or beta versions) or need to send logs to support, close the game and start again.
Instructions for version 10.3.1 and older
1. Open the modpack folder
* CurseForge App: right click on the modpack tile → `Open Folder`
* Modrinth App: right click on the modpack tile → `📂 Open folder`
* Prism Launcher: right click on the instance → `Folder` → `.minecraft`
* MultiMC: right click on the instance → `Minecraft Folder`
* Minecraft Launcher: click `Installations` → hover on the instance → click `📁`
2. Delete the `config` folder
* If you prefer, also delete `options.txt` which stores vanilla options
3. Download [your version of FO again from Modrinth](https://modrinth.com/modpack/fabulously-optimized/versions)
4. Rename the file to `pack.zip`
5. Open the file you renamed, go to `overrides`
6. Copy/extract the folder `configs` out to the modpack folder you previously opened
* You may delete the `pack.zip` after you're done
7. Launch the game. Modpack's defaults are now applied!