# Install instructions
Here are the instructions to install Fabulously Optimized to various launchers.
Can't use Minecraft 1.17 and higher due to hardware limits? [Follow this tutorial](https://gist.github.com/Kichura/9fa44010d8ed9e5733d258292e327001) and then retry.
## Supported
### [CurseForge Launcher](https://download.curseforge.com/#download-options)
1. Go to [the listing page](https://www.curseforge.com/minecraft/modpacks/fabulously-optimized/) on CurseForge
2. Click `Install`
3. Accept the prompt (if asked), download should start in the launcher
4. To run the modpack, hover on the modpack icon and click `Play`
5. Once the Minecraft Launcher has opened, click `Play` again
Or with the launcher already open:
1. Select *Minecraft* from the grid or sidebar
2. Search "Fabulously Optimized"
3. Click `Install`
4. To run the modpack, hover on the modpack icon and click `Play`
5. Once the Minecraft Launcher has opened, click `Play` again
### [Prism Launcher](https://prismlauncher.org/)
You need [Java 17 or higher](https://prismlauncher.org/wiki/getting-started/installing-java/) to play the game.
1. Click `Add Instance`
2. Select `Modrinth` tab from the left
3. Select "Fabulously Optimized"
4. Click `OK`
5. The modpack will now install.
6. Once installed, double-click the icon to play.
### [Steam Deck](https://www.steamdeck.com/) + Prism Launcher
1. With Steam Deck turned on, hold down `⏻` (power) and tap `Switch to Desktop`.
2. From the taskbar, select 👜 "Discover".
3. Tap the searchbar on the top left corner, then press ❎ to open the on-screen keyboard.
4. Search for "Prism Launcher" and tap `Install` on the first result.
5. Launch it and go through its initial setup process, then close it.
6. Open Steam app, select `Games` → `Add a Non-Steam Game to My Library...` → select Prism Launcher → `ADD SELECTED PROGRAMS`.
7. Close Steam and launch `Return to Gaming Mode`.
8. Launch Prism Launcher from your game library.
9. Tap `Add Instance`
10. Select `Modrinth` tab from the left
11. Select "Fabulously Optimized"
12. Click `OK`
13. The modpack will now install.
14. Once installed, double-tap the icon and wait.
15. Tap `Options...` → `Controls...` → `Controller Settings...`
16. Select a controller, then `Done` → `Done` → `Done`
17. The game is now set up and you can just launch it from your game library from now on.
18. Bonus: if you want a better icon in your game library, [follow these instructions](https://prismlauncher.org/download/steam-deck/#setting-up-artwork).
P.S. If you get Deck-specific issues, try asking on [r/SteamDeck](https://www.reddit.com/r/steamdeck) as FO moderators may not have one.
### [MultiMC](https://multimc.org)
You need [Java 17 or higher](https://adoptium.net/) to play the game.
1. Click `Add Instance`
2. Select `Modrinth` tab from the left
3. Select "Fabulously Optimized"
4. Click `OK`
5. The modpack will now install.
6. Once installed, double-click the icon to play.
### [MultiMC](https://multimc.org) (auto-update)
You need [Java 17 or higher](https://adoptium.net/) to play the game.
1. Go to [readme](https://github.com/Fabulously-Optimized/fabulously-optimized#downloads), click "Alternative downloads"
2. Click the version number you need in the MultiMC (auto-update) section
3. Drag the ZIP-archive to MultiMC window, and hit OK in the window that pops up.
4. Double-click that version you just created to download and launch the modpack
Need to download some mods manually?
If you get asked to download a specific jar, it means I am 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](https://www.minecraft.net/en-us/download) (vanilla)
For macOS or Linux [you need Java](https://adoptium.net/) to run the Fabric Installer.
1. Download and install [Fabric Loader](https://fabricmc.net/use/) **version 0.14.22**
* Older versions of the modpack - 1.12.3, 2.7.3 and 3.14.1 require the use of Fabric Loader 0.14.12 instead.
* Remember that the *installer version* doesn't matter, what matters is the *loader version* that appears when you run the installer.
2. Download some mods manually as needed:
* **FO 5.2.4**: Download [Sodium](https://modrinth.com/mod/sodium/version/mc1.20-0.4.10) and [Iris](https://modrinth.com/mod/iris/version/1.6.4+1.20)
* **FO 4.11.0**: Download [Sodium](https://modrinth.com/mod/sodium/version/mc1.19.4-0.4.10)
3. Open Minecraft Launcher, click `Installations`, then click 📂 on the Fabric installation
4. Go to [Files](https://www.curseforge.com/minecraft/modpacks/fabulously-optimized/files) on CurseForge
5. Click the topmost version, scroll down to "Additional files" section
6. Click `⋮` → `Download file` on the latest **MultiMC version**
* If you see less than 10 mods in the zip, you downloaded the wrong version.
7. Open the zip file, go to *Fabulously Optimized x.x.x* > *minecraft*
8. Copy **all folders** from zip's *minecraft* folder to your *.minecraft* folder; if asked - replace the files
9. **FO 4.11.0+**: Copy downloaded mod JAR(s) to *mods* folder
10. It is highly recommended to delete `options.txt` as well to get [FO default settings](https://wiki.download.fo/~/revisions/I9KOWRty9G5rjP5vZJFI/readme/changed-options)
* Your vanilla options like selected resource packs, language, keybinds will be reset but you can reapply them later.
* If you choose not to do this, it is recommended to at least enable bundled resource packs manually.
11. Launch the installed Fabric profile
12. If you now see "Fabulously Optimized" in the right bottom corner, you're done!
A simple installer for vanilla launcher [is coming soon](https://github.com/Fabulously-Optimized/fabulously-optimized/issues/110)!
## Not supported
### GDLauncher
Due to technical limits and issues, GDLauncher is no longer supported. It is recommended to migrate to Prism Launcher:
1. [Install and run Prism Launcher](https://prismlauncher.org/)
2. Click `Add Instance`
3. Select `Modrinth` tab from the left
4. Select "Fabulously Optimized"
5. Click `OK`
6. The modpack will now install.
7. Once installed, click the `Folder` button on the left.
8. Open GDLauncher
9. Right click on your previously used instance → `Open Folder`
10. Copy the important files and folders over:
* `saves` for your local worlds
* `resourcepacks`, if you use any (do not copy old versions of FO-bundled packs though)
* `screenshots`
* `servers.dat` for your multiplayer servers
* `options.txt`, if you want to keep your vanilla option changes
11. Launch the instance on Prism and confirm everything is correct
12. Uninstall GDLauncher
[GDLauncher Carbon](https://gdlauncher.com/en/blog/curseforge-partnership-announcement/) may be supported in the future.
### Modrinth app
Fabulously Optimized is [available on Modrinth](https://modrinth.com/modpack/fabulously-optimized), but Modrinth's own official launcher is currently in open beta with some bugs. When it gets released and the required bugs fixed, it will be supported. For now see [Prism Launcher](#prism-launcher) for a different launcher that also downloads from Modrinth.
### Pojav Launcher
Pojav Launcher is not yet supported due to drawbacks (long installation process, high energy usage, performance may not be better etc), but is being considered.
### ATLauncher
*Not to be confused with* [*TLauncher*](#tlauncher)*.*
ATLauncher is currently not supported simply because the interface is confusing and complex. There have been discussions with its developer to improve this and it may be considered in the future.
### PolyMC
[**PolyMC is compromised**](https://github.com/Fabulously-Optimized/fabulously-optimized/issues/496) **and you should uninstall it immediately!**
To migrate to Prism Launcher (a safe fork of PolyMC), follow these instructions:
1. Uninstall PolyMC
2. Install [Prism Launcher](https://prismlauncher.org/)
3. Launch it and pay attention to the prompt you get:
1. > It looks like you used PolyMC before. Do you want to migrate your data to the new location of Prism Launcher?
* Click `Yes` and the migration will complete.
2. > It looks like you used PolyMC on Windows before. Do you want to migrate your data to the new location of Prism Launcher?
* Click `Yes` and the migration will complete.
3. > Old data from PolyMC was found, but you already have existing data for Prism Launcher. Sadly you will need to migrate yourself. Do you want to be reminded of the pending data migration next time you start Prism Launcher?
* Click `No` and follow manual migration instructions below.
4. If needed, [update](https://wiki.download.fo/~/revisions/I9KOWRty9G5rjP5vZJFI/update-instructions#prism-launcher) or [install](#prism-launcher) the modpack again
5. To run the modpack, double click the Fabulously Optimized icon
Manual migration
1. Close Prism Launcher
2. Go to one of these directories according to your operating system:
* Portable (Windows/Linux): `PolyMC/instances`
* Windows: `%APPDATA%/PolyMC/instances`
* macOS: `~/Library/Application Support/PolyMC/instances`
* Linux: `~/.local/share/PolyMC/instances`
3. Select all the files and folders in the instances folder, right click on one of them and select `Copy`
4. Open Prism Launcher, click `Folders`, then `View Instance Folder`
5. Once your instance folder has opened, right click anywhere and select `Paste`
6. Close Prism Launcher and reopen it, your instances should be there
7. Sign in to your accounts, configure Prism Launcher to your preferences
### TLauncher
*Not to be confused with* [*ATLauncher*](#atlauncher)*.*
[TLauncher is malware](https://www.youtube.com/watch?v=SBTH9n6lz9o), so it will never be supported by Fabulously Optimized. It is highly recommended to [reset your entire computer](https://www.howtogeek.com/202590/stop-trying-to-clean-your-infected-computer-just-nuke-it-and-reinstall-windows/), then come back to this page and follow install instructions for any supported launcher.
### Cracked launchers
Any launchers that let you run the game without having purchased it first are not supported.
There is a legitimate way to obtain Minecraft for cheaper: [get a giftcode from a trusted reseller!](https://punktid.com/minecraft-java-bedrock) Sign up with [this referral link for additional 10% off](https://punktid.com/?ref=robotkoer). After that, pick any supported launcher from this page and enjoy the game!
### Other launchers
Technically you can install it in *some* other launchers that support CurseForge or Modrinth modpacks or in *any* launcher by following the vanilla instructions. However, please do not ask for support if you use an unsupported launcher.
### Other modpacks
Some users have experienced interest in using FO with other, content-focused modpacks.
While it is theoretically possible, this is **not advised**:
* mods may have conflicts
* neither FO or the other modpack will be able to support you
Instead, we recommend you to use FO with [other mods added by you](https://wiki.download.fo/~/revisions/I9KOWRty9G5rjP5vZJFI/readme/adding-more-mods).
### Game clients
Fabulously Optimized is not compatible with any "game clients", including "hacked clients" and "PvP clients". [Use normal mods instead!](https://wiki.download.fo/~/revisions/I9KOWRty9G5rjP5vZJFI/readme/adding-more-mods)
### Bedrock Edition
Fabulously Optimized is not compatible with Bedrock Edition.
## Servers
Any server is supported, no installation is necessary. See [server setup](https://wiki.download.fo/~/revisions/I9KOWRty9G5rjP5vZJFI/readme/server-setup) for tips.
## Quilt
Fabulously Optimized is currently based on Fabric, not Quilt. It *may* run on [Quilt](https://quiltmc.org), but it has not been tested and is not currently supported to ensure all mods work reliably. If you use it, do not ask for support in FO's Discord, but rather [Quilt's Discord](https://discord.quiltmc.org/).
If there becomes a need, Fabulously Optimized will move to Quilt overall and then it will be fully supported. Read more on [issue #257](https://github.com/Fabulously-Optimized/fabulously-optimized/issues/257).