Fabulously-Optimized · its-miroma · Jan 16, 2025 · Jan 17, 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/disable-mods/README.md b/how-to/disable-mods/README.md
@@ -0,0 +1,16 @@
+---
+hidden: true
+icon: square-minus
+---
+
+# Disable Mods
+
+<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" %}
+Do NOT disable "API" or "library" mods, because the other mods rely on them.
+{% endhint %}
+
+{% hint style="info" %}
+You may be able to simply [toggle the mod through the Mod Menu](../../info/resource-packs/#mod-menu-helper).
+{% endhint %}
diff --git a/how-to/disable-mods/curseforge-app.md b/how-to/disable-mods/curseforge-app.md
@@ -0,0 +1,20 @@
+---
+hidden: true
+---
+
+# CurseForge App
+
+{% hint style="danger" %}
+Do NOT disable "API" or "library" mods, because the other mods need them.
+{% endhint %}
+
+1. Open the **CurseForge App**
+2. Select **Minecraft** from the grid or from the sidebar
+3. In **My Modpacks**, click on <kbd>**Fabulously Optimized**</kbd>
+4. Click on the <kbd>**three dots**</kbd> button
+5. Click on <kbd>**Profile Options**</kbd>
+6. Check the <kbd>**Allow content management for this profile**</kbd> checkbox
+7. Click on <kbd>**Done**</kbd>
+8. Find the mod you want to disable
+9. Toggle the knob
+10. If you want to re-enable the mod, toggle the knob again
diff --git a/how-to/disable-mods/modrinth-app.md b/how-to/disable-mods/modrinth-app.md
@@ -0,0 +1,16 @@
+---
+hidden: true
+---
+
+# Modrinth App
+
+{% hint style="danger" %}
+Do NOT disable "API" or "library" mods, because the other mods need them.
+{% endhint %}
+
+1. Open the **Modrinth App**
+2. Click on the <kbd>**Library**</kbd>
+3. Click on <kbd>**Fabulously Optimized**</kbd>
+4. Find the mod you want to disable
+5. Toggle the knob
+6. If you want to re-enable the mod, toggle the knob again
diff --git a/how-to/disable-mods/multimc.md b/how-to/disable-mods/multimc.md
@@ -0,0 +1,98 @@
+---
+hidden: true
+---
+
+# MultiMC
+
+{% hint style="danger" %}
+Do NOT disable "API" or "library" mods, because the other mods need them.
+{% endhint %}
+
+Instructions vary depending on whether you had installed FO on MultiMC with the easier installation or with automatic updates.
+
+<!-- TODO: instructions for manual installation? -->
+
+{% tabs %}
+{% tab title="Windows" %}
+{% hint style="info" %}
+Tutorial by [Ultrasonic1209](https://github.com/Ultrasonic1209) based on [Remty5's workaround](https://github.com/Fabulously-Optimized/fabulously-optimized/issues/81).
+{% endhint %}
+
+1. Open **MultiMC**
+2. Right-click on <kbd>**Fabulously Optimized**</kbd>
+3. Click on the <kbd>**Instance Folder**</kbd> button
+4. While holding <kbd>⇧ Shift</kbd>, right-click inside of the folder
+5. Click on <kbd>**Open in Terminal**</kbd> or <kbd>**Open with PowerShell**</kbd> or similar
+6. Run the following commands to download the scripts that will disable the mods:
+
+    ```powershell
+    (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Fabulously-Optimized/fabulously-optimized/main/Packwiz/pre-launch.ps1" -OutFile "pre-launch.ps1")
+    (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Fabulously-Optimized/fabulously-optimized/main/Packwiz/post-exit.ps1" -OutFile "post-exit.ps1")
+    ```
+
+    This should download two files: `pre-launch.ps1` and `post-exit.ps1`
+7. Open `pre-launch.ps1` in a text editor. You should find a list of mods starting on _line 4_
+8. Copy the name of the mod you want to disable
+9. Paste the name of the mod in the line you found in _step 7_
+10. Disable more mods by adding them under _line 4_ with the same format
+11. Go back to **MultiMC**
+12. Click on <kbd>**Fabulously Optimized**</kbd>
+13. Click on <kbd>**Edit Instance**</kbd>
+14. Replace the pre-launch command with the following:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File ..\pre-launch.ps1
+```
+
+15. Replace the post-exit command with the following:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File ..\pre-launch.ps1
+```
+{% endtab %}
+
+{% tab title="Linux and macOS" %}
+{% hint style="info" %}
+Tutorial by [RaptaG](https://github.com/RaptaG) based on [Remty5's workaround](https://github.com/Fabulously-Optimized/fabulously-optimized/issues/81).
+{% endhint %}
+
+{% hint style="warning" %}
+Not fully tested on macOS!
+{% endhint %}
+
+1. Open **MultiMC**
+2. Right-click on <kbd>**Fabulously Optimized**</kbd>
+3. Click on the <kbd>**Instance Folder**</kbd> button
+4. Right-click inside of the folder
+5. Click on <kbd>**Open in Terminal**</kbd>
+   * On macOS follow [instructions to get the Terminal there](https://petenetlive.com/KB/Article/0001060)
+6. Install [`jq`](https://stedolan.github.io/jq/download), which will automatically adapt the script to your Minecraft version
+7. Run the following commands to download the scripts that will disable the mods:
+
+    ```sh
+    curl -Os 'https://raw.githubusercontent.com/Fabulously-Optimized/fabulously-optimized/main/Packwiz/pre-launch.sh' | curl -Os 'https://raw.githubusercontent.com/Fabulously-Optimized/fabulously-optimized/main/Packwiz/post-exit.sh' && chmod +x pre-launch.sh post-exit.sh
+    ```
+
+    This should download two files: `pre-launch.ps1` and `post-exit.ps1`
+8. Open `pre-launch.ps1` in a text editor. You should find a list of mods starting on _line 6_
+9. Copy the name of the mod you want to disable
+10. Paste the name of the mod in the line you found in _step 8_
+11. Disable more mods by adding them under _line 6_ with the same format
+12. If you leave a line empty, delete the corresponding one starting on _line 28_
+13. If you need to disable more than 6 mods, add lines both under `mod5=` and `$mod5.jar\`
+14. Go back to **MultiMC**
+15. Click on <kbd>**Fabulously Optimized**</kbd>
+16. Click on <kbd>**Edit Instance**</kbd>
+17. Replace the pre-launch command with the following:
+
+```sh
+../pre-launch.ps1
+```
+
+18. Replace the post-exit command with the following:
+
+```sh
+../pre-launch.ps1
+```
+{% endtab %}
+{% endtabs %}
diff --git a/how-to/disable-mods/prism-launcher.md b/how-to/disable-mods/prism-launcher.md
@@ -0,0 +1,17 @@
+---
+hidden: true
+---
+
+# Prism Launcher
+
+{% hint style="danger" %}
+Do NOT disable "API" or "library" mods, because the other mods need them.
+{% endhint %}
+
+1. Open the **Prism Launcher**
+2. Select <kbd>**Fabulously Optimized**</kbd>
+3. Click on <kbd>**Edit**</kbd>
+4. Click on <kbd>**Mods**</kbd>
+5. Find the mod you want to disable
+6. Uncheck the checkbox
+7. If you want to re-enable the mod, check the checkbox again
diff --git a/how-to/disable-mods/vanilla.md b/how-to/disable-mods/vanilla.md
@@ -0,0 +1,21 @@
+---
+hidden: true
+---
+
+# Minecraft Launcher
+
+{% hint style="danger" %}
+Do NOT disable "API" or "library" mods, because the other mods need them.
+{% endhint %}
+
+1. Open the **Minecraft Launcher**
+2. Select the Fabric installation
+3. Click on <kbd>**Folder**</kbd> button
+4. Open the `mods/` folder
+5. Find the mod you want to disable
+6. Rename the mod from `mod-name.jar` to `mod-name.jar.disabled`
+7. If you want to re-enable the mod, rename `mod-name.jar.disabled` to `mod-name.jar`
+
+{% hint style="info" %}
+If you can't see the `.jar` extension in the file name, follow this [tutorial to show file extensions](https://thewindowsclub.com/show-file-extensions-in-windows).
+{% endhint %}