Skip to content

Commit df9e522

Browse files
committed
rewrite(how-to/install/modrinth-app): via website
- use `kbd` for all UI buttons - targeted hint for MultiMC - use buttons for MultiMC - drop inaccurate historical details about CurseForge MultiMC pack
1 parent 015f643 commit df9e522

File tree

7 files changed

+130
-102
lines changed

7 files changed

+130
-102
lines changed

how-to/install/README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,12 @@ icon: down-to-bracket
77

88
<table data-card-size="large" 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><br>The Modrinth App supports FO with monetary benefits. Thank you!</td><td><a href="modrinth-app.md">modrinth-app.md</a></td></tr><tr><td align="center"><strong>CurseForge App</strong><br>The CurseForge App supports FO with monetary benefits. Thank you!</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><tr><td align="center"><strong>Steam Deck</strong></td><td><a href="steam-deck.md">steam-deck.md</a></td></tr><tr><td align="center">Why am I not seeing my favorite launcher?</td><td><a href="../../about/unsupported.md#other-launchers">#other-launchers</a></td></tr></tbody></table>
99

10+
<details><summary>Comparison table</summary>
11+
12+
TODO
13+
14+
</details>
15+
1016
{% hint style="success" %}
1117
FO does not require any special setup server-side: any server compatible with vanilla should be supported.
1218

@@ -16,5 +22,3 @@ Read more [tips regarding server setup](../../about/servers.md).
1622
{% hint style="info" %}
1723
Are you unable to play Minecraft 1.17 or higher due to hardware limitations? Follow this [tutorial to work around the compatibility issue](https://gist.github.com/Kichura/9fa44010d8ed9e5733d258292e327001), then try again.
1824
{% endhint %}
19-
20-
<!-- TODO: Comparison table -->

how-to/install/curseforge-app.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -5,26 +5,26 @@ hidden: true
55
# CurseForge App
66

77
{% tabs %}
8-
{% tab title="Through the CurseForge App" %}
8+
{% tab title="Via app" %}
99
1. Open the [**CurseForge App**](https://www.curseforge.com/download/app#download-options)
10-
2. Select **Minecraft** from the grid or from the sidebar
10+
2. Select <kbd>**Minecraft**</kbd> from the grid or from the sidebar
1111
3. Search for `Fabulously Optimized`
12-
4. Click on the Install button. Once installed, you should see a new icon for FO
13-
5. If you do not want the latest version, click on the row, then on `Versions`, then on the download button
12+
4. Click on the <kbd>**Install**</kbd> button. Once installed, you should see a new icon for FO
13+
5. If you do not want the latest version, click on the row, then on <kbd>**Versions**</kbd>, then on the <kbd>**Download**</kbd> button
1414
6. Hover over the icon that just appeared
15-
7. Click the Play button. The Minecraft Launcher should open up
16-
8. In the Minecraft Launcher, click on the Play button. Minecraft should open up
15+
7. Click on the <kbd>**Play**</kbd> button. The Minecraft Launcher should open up
16+
8. In the Minecraft Launcher, click on the <kbd>**Play**</kbd> button. Minecraft should open up
1717
9. If you can see `Fabulously Optimized` in the bottom-right corner, you're done!
1818
{% endtab %}
1919

20-
{% tab title="Through the CurseForge website" %}
20+
{% tab title="Via website" %}
2121
1. Open [FO's listing on CurseForge](https://download.fo/curseforge)
22-
2. Click on the Install button
23-
3. If you do not want the latest version, click on `Files`, then on the version you want, then on the Install button
22+
2. Click on the <kbd>**Install**</kbd> button
23+
3. If you do not want the latest version, click on <kbd>**Files**</kbd>, then on the version you want, then on the <kbd>**Install**</kbd> button
2424
4. If a prompt appears asking to open in the CurseForge App, accept it. The CurseForge App should open, and the download should start. Once installed, you should see a new icon for FO
2525
5. Hover over the icon that just appeared
26-
6. Click the Play button. The Minecraft Launcher should open up
27-
7. In the Minecraft Launcher, click on the Play button. Minecraft should open up
26+
6. Click on the <kbd>**Play**</kbd> button. The Minecraft Launcher should open up
27+
7. In the Minecraft Launcher, click on the <kbd>**PLAY**</kbd> button. Minecraft should open up
2828
8. If you can see `Fabulously Optimized` in the bottom-right corner, you're done!
2929
{% endtab %}
3030
{% endtabs %}

how-to/install/modrinth-app.md

Lines changed: 23 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -8,14 +8,31 @@ hidden: true
88
These instructions are for Modrinth App version 0.9.2 or higher.
99
{% endhint %}
1010

11+
{% tabs %}
12+
{% tab title="Via app" %}
1113
1. Open the [**Modrinth App**](https://modrinth.com/app)
12-
2. Under the **Discover a modpack** section, click on "Fabulously Optimized"
13-
3. Click on the Install button
14-
4. If you do not want the latest version, click on the tile, then on `Versions`, then on the download button
15-
5. Go to the **Library** section
16-
6. Hover over the newly created FO instance
17-
7. Click on the Play button. Minecraft should open up
14+
2. Under the **Discover a modpack** section, click on <kbd>**Fabulously Optimized**</kbd>
15+
3. Click on the <kbd>**Install**</kbd> button
16+
4. If you do not want the latest version, click on the tile, then on <kbd>**Versions**</kbd>, then on the <kbd>**Download**</kbd> button
17+
5. Go to the <kbd>**Library**</kbd> section
18+
6. Hover over the newly created **Fabulously Optimized** instance
19+
7. Click on the <kbd>**Play**</kbd> button. Minecraft should open up
1820
8. If you can see `Fabulously Optimized` in the bottom-right corner, you're done!
21+
{% endtab %}
22+
23+
{% tab title="Via website" %}
24+
1. Open [FO's listing on Modrinth](https://download.fo/modrinth)
25+
2. Click on the <kbd>**Download**</kbd> button
26+
3. Click on <kbd>**Install with Modrinth App**</kbd>. The Modrinth App should open
27+
4. If you do not want the latest version, click on <kbd>**Select game version**</kbd>, then select the desired version
28+
5. If a prompt appears asking to open in the Modrinth App, accept it. The Modrinth App should open, and the download should start.
29+
6. Once installed, click on <kbd>**Install**</kbd>
30+
7. Go to the <kbd>**Library**</kbd>
31+
8. Hover over the newly created **Fabulously Optimized** instance
32+
9. Click on <kbd>**Play**</kbd>. Minecraft should open up
33+
10. If you can see the newly installed content in the Mod Menu, you're done!
34+
{% endtab %}
35+
{% endtabs %}
1936

2037
{% hint style="success" %}
2138
The Modrinth App supports FO with monetary benefits. Thank you!

how-to/install/multimc.md

Lines changed: 32 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -6,36 +6,39 @@ hidden: true
66

77
[MultiMC](https://multimc.org/) does not support automatic updates by default. However, FO has developed a custom MultiMC pack to perform updates automatically. Read more about the [MultiMC auto-updating pack](multimc.md#how-does-it-work)
88

9-
{% hint style="info" %}
10-
You may also want to use one of the other [launchers supported by FO](./), which offer easier installation, updates and mod management.
9+
{% tabs %}
10+
{% tab title="Automatic Updates" %}
11+
{% hint style="warning" %}
12+
While this variant allows for automatic updates within a specific Minecraft version, it is more difficult to update across Minecraft versions and to disable FO's mods.
13+
14+
Consider using [Prism Launcher](prism-launcher.md), which has a similar interface and a version manager.
1115
{% endhint %}
1216

13-
{% tabs %}
14-
{% tab title="Automatic Updates (recommended)" %}
1517
1. Download and install [Java 21](https://download.fo/java21)
1618
2. Download FO's MultiMC pack for your preferred Minecraft version from [GitHub Releases](https://github.com/Fabulously-Optimized/fabulously-optimized/releases):
17-
* [`1.21.5`](https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v6.6.0-alpha.8/Fabulously.Optimized.MC.1.21.5.auto-update.zip)
18-
* [`1.21.4`](https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v6.6.0-alpha.8/Fabulously.Optimized.MC.1.21.4.auto-update.zip)
19-
* [`1.21.1`](https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v6.6.0-alpha.8/Fabulously.Optimized.MC.1.21.1.auto-update.zip)
20-
* [`1.20.6`](https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v5.12.0-beta.11/Fabulously.Optimized.MC.1.20.6.auto-update.zip)
21-
* [`1.19.4`](https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v4.10.0/Fabulously.Optimized.MC.1.19.4.auto-update.zip)
22-
* [`1.18.2`](https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v3.12.2/Fabulously.Optimized.MC.1.18.2.auto-update.zip)
23-
* [`1.17.1`](https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v3.2.3/Fabulously.Optimized.MC.1.17.1.auto-update.zip)
24-
* [`1.16.5`](https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v3.2.3/Fabulously.Optimized.MC.1.16.5.auto-update.zip)
19+
20+
<a class="button primary" href="https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v6.6.0-alpha.8/Fabulously.Optimized.MC.1.21.5.auto-update.zip">1.21.5</a>
21+
<a class="button secondary" href="https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v6.6.0-alpha.8/Fabulously.Optimized.MC.1.21.4.auto-update.zip">1.21.4</a>
22+
<a class="button secondary" href="https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v6.6.0-alpha.8/Fabulously.Optimized.MC.1.21.1.auto-update.zip">1.21.1</a>
23+
<a class="button secondary" href="https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v5.12.0-beta.11/Fabulously.Optimized.MC.1.20.6.auto-update.zip">1.20.6</a>
24+
<a class="button secondary" href="https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v4.10.0/Fabulously.Optimized.MC.1.19.4.auto-update.zip">1.19.4</a>
25+
<a class="button secondary" href="https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v3.12.2/Fabulously.Optimized.MC.1.18.2.auto-update.zip">1.18.2</a>
26+
<a class="button secondary" href="https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v3.2.3/Fabulously.Optimized.MC.1.17.1.auto-update.zip">1.17.1</a>
27+
<a class="button secondary" href="https://github.com/Fabulously-Optimized/fabulously-optimized/releases/download/v3.2.3/Fabulously.Optimized.MC.1.16.5.auto-update.zip">1.16.5</a>
2528
3. If you do not want the latest version, you can find older ones in [GitHub Releases](https://github.com/Fabulously-Optimized/fabulously-optimized/releases)
2629
4. Open [**MultiMC**](https://multimc.org/)
2730
5. Drag the `zip` file and drop it inside of MultiMC's window. A window should pop up
28-
6. Click **OK** in that window. Something should happen
31+
6. Click on <kbd>**OK**</kbd> in that window. Something should happen
2932
7. Double-click on that window. The download should start
3033
8. If you are asked to download a mod manually:
3134
1. Open the given address in your browser. The mod's page should open up
32-
2. Click on **Cancel Launch**
33-
3. Click on **Download**. A `jar` file should be downloaded
34-
4. Go back to **MultiMC**
35-
5. Click on the instance you just created
36-
6. Click on **View Mods**
35+
2. Click on <kbd>**Cancel Launch**</kbd>
36+
3. Click on <kbd>**Download**</kbd>. A `jar` file should be downloaded
37+
4. Go back to **MultiMC**. You should find a new instance
38+
5. Click on the <kbd>**Fabulously Optimized**</kbd> instance
39+
6. Click on <kbd>**View Mods**</kbd>
3740
7. Drag the mod you downloaded in _step 8.3_ and drop it in the mod list
38-
9. Click on **Launch**. Minecraft should open up
41+
9. Click on <kbd>**Launch**</kbd>. Minecraft should open up
3942
10. If you can see `Fabulously Optimized` in the bottom-right corner, you're done!
4043

4144
### How Does It Work?
@@ -45,22 +48,21 @@ The MultiMC auto-updating pack launches [`packwiz`](https://github.com/comp500/p
4548
Since the update checker runs on every launch, you'll get a skippable error if you play offline. The updater only manages FO's mods, not the [mods added manually](../add-mods/multimc.md). The updater does not work across Minecraft versions, so you'll need to install it again every time.
4649

4750
MultiMC does not natively support automatic updates of packs: see [issue #2640](https://github.com/MultiMC/MultiMC5/issues/2640) and [issue #3037](https://github.com/MultiMC/MultiMC5/issues/3057). FO chose to use `packwiz` because it is also used for the [vanilla installer](vanilla.md).
48-
49-
Before FO 6.0.0, the MultiMC auto-updating pack was distributed on CurseForge, but that has changed for the following reasons:
50-
51-
* CurseForge's UI for downloading the MultiMC auto-updating pack became confusing
52-
* The pack had to be re-uploaded on every update, which was often unnecessary
53-
* The pack's downloads via CurseForge [might not support FO](https://support.curseforge.com/en/support/solutions/articles/9000197898-rewards-program-terms-of-service#1.-Description-of-Rewards-Program) as previously thought
54-
* The pack proved to have unexpected issues that do not exist with other launchers
5551
{% endtab %}
5652

5753
{% tab title="Easier Installation" %}
54+
{% hint style="warning" %}
55+
Installing FO through these instructions means that every update will require manual configuration.
56+
57+
Consider using [Prism Launcher](prism-launcher.md), which has a similar interface and a version manager.
58+
{% endhint %}
59+
5860
1. Download and install [Java 21](https://download.fo/java21)
59-
2. In [**MultiMC**](https://multimc.org/), click on **Add Instance**
60-
3. Click on the **Modrinth** tab on the left
61-
4. Click on **Fabulously Optimized**
61+
2. In [**MultiMC**](https://multimc.org/), click on <kbd>**Add Instance**</kbd>
62+
3. Click on the <kbd>**Modrinth**</kbd> tab on the left
63+
4. Click on <kbd>**Fabulously Optimized**</kbd>
6264
5. If you do not want the latest version of FO, select the version you want from the dropdown
63-
6. Click on **OK**. Once installed, something should happen
65+
6. Click on <kbd>**OK**</kbd>. Once installed, something should happen
6466
7. Double-click on the icon. Minecraft should open up
6567
8. If you can see `Fabulously Optimized` in the bottom-right corner, you're done!
6668
{% endtab %}

how-to/install/prism-launcher.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,9 +5,9 @@ hidden: true
55
# Prism Launcher
66

77
1. Open the [**Prism Launcher**](https://prismlauncher.org/)
8-
2. Click on the **Modrinth** tab on the left
9-
3. Click on **Fabulously Optimized**
8+
2. Click on the <kbd>**Modrinth**</kbd> tab on the left
9+
3. Click on <kbd>**Fabulously Optimized**</kbd>
1010
4. If you do not want the latest version, select the version you want from the dropdown
11-
5. Click on **OK**. Once installed, you should see something <!-- TODO: what though? -->
12-
6. Double-click the icon to play. Minecraft should open up
11+
5. Click on <kbd>**OK**</kbd>. Once installed, you should see something
12+
6. Double-click on the icon to play. Minecraft should open up
1313
7. If you can see `Fabulously Optimized` in the bottom-right corner, you're done!

how-to/install/steam-deck.md

Lines changed: 20 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -6,27 +6,30 @@ hidden: true
66

77
You'll install FO on your Steam Deck via [Prism Launcher](prism-launcher.md).
88

9-
1. Hold down the Power button on your Steam Deck
10-
2. Tap on **Switch to Desktop**
11-
3. Select **Discover** from the taskbar
12-
4. Tap the Search bar on the top-left corner
13-
5. Tap the X to open the on-screen keyboard
14-
6. Search for **Prism Launcher**
15-
7. Tap **Install** on the first result
9+
1. Hold down the <kbd>Power</kbd> button on your Steam Deck
10+
2. Tap on <kbd>**Switch to Desktop**</kbd>
11+
3. Select <kbd>**Discover**</kbd> from the taskbar
12+
4. Tap the <kbd>**Search**</kbd> bar on the top-left corner
13+
5. Tap the <kbd>****</kbd> to open the on-screen keyboard
14+
6. Search for <kbd>**Prism Launcher**</kbd>
15+
7. Tap <kbd>**Install**</kbd> on the first result
1616
8. Launch the **Prism Launcher**
1717
9. Go through Prism Launcher's initial setup process
1818
10. Close Prism Launcher
1919
11. Open the **Steam** app
20-
12. Tap on **Games**, then on **Add a non-Steam game to my library**, then select Prism Launcher, then tap on **Add selected programs**
21-
13. Close the Steam app
22-
14. Launch **Return to Gaming Mode**
23-
15. Launch **Prism Launcher** from your game library
24-
16. Follow the [instructions for the Prism Launcher](prism-launcher.md). Once you've opened Minecraft, come back here
25-
17. Tap on **Options...**, then on **Controls...**, then on **Controller Settings...**
26-
18. Select your controller
27-
19. Tap on **Done** three times
28-
20. You can launch the game from your game library from now on
29-
21. If you want a better icon in your game library, follow the [instructions for setting up artwork](https://prismlauncher.org/download/steam-deck/#setting-up-artwork)
20+
12. Tap on <kbd>**Games**</kbd>
21+
13. Tap on <kbd>**Add a non-Steam game to my library**</kbd>
22+
14. Select Prism Launcher
23+
15. Tap on <kbd>**Add selected programs**</kbd>
24+
16. Close the Steam app
25+
17. Launch **Return to Gaming Mode**
26+
18. Launch **Prism Launcher** from your game library
27+
19. Follow the [instructions for the Prism Launcher](prism-launcher.md). Once you've opened Minecraft, come back here
28+
20. Tap on <kbd>**Options...**</kbd>, then on <kbd>**Controls...**</kbd>, then on <kbd>**Controller Settings...**</kbd>
29+
21. Select your controller
30+
22. Tap on <kbd>**Done**</kbd> three times
31+
23. You can launch the game from your game library from now on
32+
24. If you want a better icon in your game library, follow the [instructions for setting up artwork](https://prismlauncher.org/download/steam-deck/#setting-up-artwork)
3033

3134
{% hint style="warning" %}
3235
If you get Deck-related issues, try asking on [r/SteamDeck on Reddit](https://old.reddit.com/r/steamdeck). FO moderators might not be able to help you.

0 commit comments

Comments
 (0)