Pojav Launcher instructions

adding-more-mods.md

@@ -56,6 +56,15 @@ Method 2:
 6. Once downloaded, copy the JAR file to the pack's "mods" folder.
 7. Run the game as usual. You should now have the new mod(s) installed!
 
+### Pojav Launcher (Android)
+
+1. Open [CurseForge mods page, set Game Version to Fabric](https://www.curseforge.com/minecraft/mc-mods?filter-game-version=2020709689:7499)
+2. Choose any mod you want and go to its _Files_ page
+3. Make sure you download the latest version that is compatible with Fabric and your Minecraft version
+4. Once downloaded, open Files
+5. Tap `☰` → `Downloads` → hold down on any file → select the mod(s) you downloaded
+6. Tap `⋮` → `Move to...` → `☰` → `PojavLauncher` → `.minecraft` → `mods`
+7. Tap `MOVE` and run the game.
 ### GDLauncher
 
 No longer supported. [Please migrate to Prism Launcher.](install-instructions.md#gdlauncher)

disabling-mods.md

@@ -54,6 +54,14 @@ Consider [switching to Prism Launcher instead,](install-instructions.md#prism-la
    * Don't see ".jar" at the end of the name? [See this page for help.](https://www.thewindowsclub.com/show-file-extensions-in-windows)
    * Rename ".jar.disabled" back to ".jar" to use the mod again.
 
+### Pojav Launcher (Android)
+
+1. Open Files
+2. Tap `☰` → `PojavLauncher` → `.minecraft` → `mods`
+    * Can't see .minecraft? Tap `⋮` → `Show hidden files` 
+3. Tap `⋮` → `Move to...` → `Move`
+    * Move it back to `mods` to use the mod again.
+
 ### GDLauncher
 
-No longer supported. [Please migrate to Prism Launcher.](install-instructions.md#gdlauncher)
+No longer supported. [Please migrate to Prism Launcher.](install-instructions.md#gdlauncher)

install-instructions.md

@@ -114,6 +114,63 @@ For macOS or Linux [you need Java](https://adoptium.net/) to run the Fabric Inst
 
 A simple installer for vanilla launcher [is coming soon](https://github.com/Fabulously-Optimized/fabulously-optimized/issues/110)!
 
+### [Pojav Launcher](https://github.com/PojavLauncherTeam/PojavLauncher) (Android)
+
+Fabulously Optimized can indeed be run on a mobile device! Be aware:
+
+* This process has a lot of steps which you must follow carefully.
+* The tutorial is made for Android devices - phones and tablets. iOS devices _could_ work, but that requires jailbreak or sideloading an alternative store, the steps are probably more complicated.
+* Your device must be "mid-range" or "high-end" if you want decent FPS. 6+ GB RAM recommended.
+* Pojav Launcher supports Android 5 and up, but these instructions were tested on Android 13.
+* Your device will likely heat and consume a lot of battery as you play. It is _not_ as device-optimized as Bedrock Edition.
+* Attempts have been made to improve performance, but depending on your device you may need to adjust video settings.
+* In the worst case, you may not get it running at all. Try again after Pojav Launcher updates.
+
+<details><summary><a href="https://play.google.com/store/apps/details?id=com.mojang.minecraftpe">I don't agree and just want to play Minecraft</a></summary></details>
+
+<details>
+  <summary>I agree and would like to see the instructions</summary>
+
+1. [Download Pojav Launcher](https://play.google.com/store/apps/details?id=net.kdt.pojavlaunch)
+   * Do not fall into scam websites and apps. The only official site for it is https://github.com/PojavLauncherTeam/PojavLauncher
+2. [Download Files](https://play.google.com/store/apps/details?id=com.marc.files)
+   * This is a shortcut to your system's file manager. Other file managers may need root to follow these instructions.
+3. [Download Fabric installer](https://fabricmc.net/use/installer/) (Universal/.JAR)
+4. [Download CurseForge GUI installer](https://github.com/Madis0/CurseForge-GUI/releases/download/694de8b/CurseForge-GUI-1.0-SNAPSHOT.jar)
+5. Download Fabulously Optimized patches for Pojav Launcher: [1.19.4](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/Fabulously-Optimized/fabulously-optimized/tree/pojav/PojavLauncher/1.19.4)
+   * This optimizes the modpack for mobile users.
+6. Run Pojav Launcher
+7. Tap `Add account` → `Microsoft account` and sign in
+8. Tap `(Default) - Unknown` → `Create new profile` → `SAVE`
+9. Tap `Play`. Wait for it to fully load to the title screen, then exit the game.
+    * If you get a RAM warning ("The current amount of..."), tap `OK` for now. It usually means you just need to close background apps for better performance.
+    * If you get a black screen: quit the game, go back to Pojav → `🎛️` → `Video and renderer` → `Renderer` → (choose any) → ⬅️ → ⬅️ → try playing again
+10. Launch Pojav again, tap `Install .jar` → select `fabric-installer-x.x.x.jar`. You'll see the Fabric installer with some logs.
+11. Tap `❌` to close the logs, then `Install` → `OK` → `⛝`
+12. Tap `Install .jar` → select `CurseForge-GUI-1.0-SNAPSHOT.jar`. You'll see a different kind of installer with some logs.
+13. Tap `❌` to close the logs, then `Install modpack` → `KEYBOARD`
+14. Enter the following code, according to the version you prefer. The keyboard may cover your screen, but try to get it right regardless.
+    * **Latest for 1.19.4**: enter `396246`.
+    * **3.14.1 for 1.18.2**: enter `396246_3983420`.
+    * **2.7.3 for 1.17.1**: enter `396246_3667614`.
+    * **1.12.3 for 1.16.5**: enter `396246_3667608`.
+15. Press Enter on the keyboard and wait for the install to complete. Once installed, press `OK` → `⛝`
+    * If you failed to enter the correct code, just close and try again from step 12.
+16. Close Pojav and open Files.
+17. Tap `☰` → `Downloads` → `(Minecraft version).zip` or `DownGit.zip` → `(Minecraft version)`
+18. Hold down on `config` folder and tap on both items, then tap `⋮` → `Extract to...`
+19. Tap `☰` → `PojavLauncher` → `curseforge-cli` → `modpack` → `fabulously-optimized_396246` → `EXTRACT`
+20. Tap `☰` → `PojavLauncher` → `curseforge-cli` → `modpack` → `fabulously-optimized_396246` → `config (2)`
+21. Hold on any file and select the other one
+21. Tap `⋮` → `Move to...` → `☰` → `PojavLauncher` → `curseforge-cli` → `modpack` → `fabulously-optimized_396246` → `config`
+22. Press `fabulously-optimized_396246` on the "address bar"
+23. Hold down on `config (2)` → tap `🗑️` → `OK`
+24. Launch Pojav, tap `New - Latest Release` → `Fabulously Optimized - ...` → `Play`.
+25. Fabulously Optimized should now be running! 
+
+</details>
+
+
 ## Not supported
 
 ### GDLauncher
@@ -145,10 +202,6 @@ Due to technical limits and issues, GDLauncher is no longer supported. It is rec
 Fabulously Optimized is [available on Modrinth](https://modrinth.com/modpack/fabulously-optimized), but an official launcher doesn't exist yet. When it gets released, 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
 
 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.
@@ -216,7 +269,7 @@ Fabulously Optimized is not compatible with any "game clients", including "hacke
 
 ### Bedrock Edition
 
-Fabulously Optimized is not compatible with Bedrock Edition.
+Fabulously Optimized is not compatible with Bedrock Edition. See [Pojav Launcher](#pojav-launcher-android) for an alternative.
 
 ## Servers
 

update-instructions.md

@@ -116,6 +116,35 @@ Currently the only way to update is to "reinstall" the pack. Consider installing
 12. Launch the installed Fabric profile
 13. If you now see "Fabulously Optimized" in the right bottom corner and its version number is newer than before, you're done!
 
+### Pojav Launcher (Android)
+
+1. [Download Fabric installer](https://fabricmc.net/use/installer/) (Universal/.JAR)
+2. [Download CurseForge GUI installer](https://github.com/Madis0/CurseForge-GUI/releases/download/694de8b/CurseForge-GUI-1.0-SNAPSHOT.jar)
+3. Download Fabulously Optimized patches for Pojav Launcher: [1.19.4](https://minhaskamal.github.io/DownGit/#/home?url=https://github.com/Fabulously-Optimized/fabulously-optimized/tree/pojav/PojavLauncher/1.19.4)
+4. Run Pojav Launcher
+5. Tap `Install .jar` → select `fabric-installer-x.x.x.jar`. You'll see the Fabric installer with some logs.
+11. Tap `❌` to close the logs, then `Install` → `OK` → `⛝`
+12. Tap `Install .jar` → select `CurseForge-GUI-1.0-SNAPSHOT.jar`. You'll see a different kind of installer with some logs.
+13. Tap `❌` to close the logs, then `Install modpack` → `KEYBOARD`
+14. Enter the following code, according to the version you prefer. The keyboard may cover your screen, but try to get it right regardless.
+    * **Latest for 1.19.4**: enter `396246`.
+    * **3.14.1 for 1.18.2**: enter `396246_3983420`.
+    * **2.7.3 for 1.17.1**: enter `396246_3667614`.
+    * **1.12.3 for 1.16.5**: enter `396246_3667608`.
+15. Press Enter on the keyboard and wait for the install to complete. Once installed, press `OK` → `⛝`
+    * If you failed to enter the correct code, just close and try again from step 12.
+16. Close Pojav and open Files.
+17. Tap `☰` → `Downloads` → `(Minecraft version).zip` or `DownGit.zip` → `(Minecraft version)`
+18. Hold down on `config` folder and tap on both items, then tap `⋮` → `Extract to...`
+19. Tap `☰` → `PojavLauncher` → `curseforge-cli` → `modpack` → `fabulously-optimized_396246` → `EXTRACT`
+20. Tap `☰` → `PojavLauncher` → `curseforge-cli` → `modpack` → `fabulously-optimized_396246` → `config (2)`
+21. Hold on any file and select the other one
+21. Tap `⋮` → `Move to...` → `☰` → `PojavLauncher` → `curseforge-cli` → `modpack` → `fabulously-optimized_396246` → `config`
+22. Press `fabulously-optimized_396246` on the "address bar"
+23. Hold down on `config (2)` → tap `🗑️` → `OK`
+24. Launch Pojav, tap `New - Latest Release` → `Fabulously Optimized - ...` → `Play`.
+25. Fabulously Optimized should now be running! 
+
 ### GDLauncher
 
 No longer supported. [Please migrate to Prism Launcher.](install-instructions.md#gdlauncher)