From 00922ed2de18a36c945d95d5af4da5b7d95643cc Mon Sep 17 00:00:00 2001
From: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
Date: Wed, 25 Sep 2024 15:15:04 +0200
Subject: [PATCH] Bundle of changes, new FAQ stuff aswell (#198)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
* added PROBLEMATIC_MODS_COMMON_FIXES
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create PROBLEMATIC-MODS-COMMON-FIXES.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Update PROBLEMATIC-MODS-COMMON-FIXES.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Update PROBLEMATIC-MODS-COMMON-FIXES.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Update PROBLEMATIC-MODS-COMMON-FIXES.md
added a few things, edited some other ones
Signed-off-by: GaucovyAero <85581164+GaucovyAero@users.noreply.github.com>
* Update PROBLEMATIC-MODS-COMMON-FIXES.md
hosted my own repo to host the patched AppletMain.class file
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
* Update JIT.md
Large update to details regarding JIT on iOS. (Dude i hope we dont have to make tutorials for this page lol)
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
* Removed ROADMAP.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Delete ROADMAP.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Update RENDERERS.md
chat did I cook
Signed-off-by: whal-whales <148692775+whal-whales@users.noreply.github.com>
* Update CUSTOM-CONTROLS.md
Signed-off-by: whal-whales <148692775+whal-whales@users.noreply.github.com>
* Create CANT-FIND-LOG.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Rename CANT-FIND-LOG.md to CANTFINDLOG.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Update CANTFINDLOG.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create CANTFINDMINECRAFT.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create ZINKNOTWORKING.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create MODCRASHING.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create MODNOTSHOWINGUP.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create RPWORLDNOTSHOWINGUP.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create CRASHES.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create MODCONFLICT.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create JAVARUNTIMES.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create JAVAVERSION.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create JARCRASHED.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Create CANTLOGIN.md
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Update config.js -Credit: @GaucovyAero
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Update JAVAVERSION.md
Thanks Bel!
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Updat
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
* bluelights phone is now the minimum
lol
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
* Update DEVICES.md
Signed-off-by: whal-whales <148692775+whal-whales@users.noreply.github.com>
* Update ABOUTPOJAV.md
changed virglrenderer to zink
Signed-off-by: whal-whales <148692775+whal-whales@users.noreply.github.com>
* Update DEVICES.md
last minute change
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
* Update DEVICES.md
wrong number sorry
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
* Update DEVICES.md
technically 2.3 drops iOS 12/13 after 3 weeks
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
* Update DEVICES.md
the minimum chipsets have 2 gb ram so i changed it
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
* Update DEVICES.md
Apple A7 technically already lost support due to the allow a7 boolean (just don’t use an a7)
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
* Update config.js
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
* Update CUSTOM-CONTROLS.md
Signed-off-by: whal-whales <148692775+whal-whales@users.noreply.github.com>
---------
Signed-off-by: Dev1ss0 <94245667+Dev1ss0@users.noreply.github.com>
Signed-off-by: GaucovyAero <85581164+GaucovyAero@users.noreply.github.com>
Signed-off-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
Signed-off-by: whal-whales <148692775+whal-whales@users.noreply.github.com>
Co-authored-by: GaucovyAero <85581164+GaucovyAero@users.noreply.github.com>
Co-authored-by: ItAnthon <145328264+ItAnthon@users.noreply.github.com>
Co-authored-by: whal-whales <148692775+whal-whales@users.noreply.github.com>
---
.vuepress/config.js | 26 ++++++++++----
ABOUTPOJAV.md | 4 +--
CANTFINDLOG.md | 18 ++++++++++
CANTFINDMINECRAFT.md | 20 +++++++++++
CANTLOGIN.md | 8 +++++
CRASHES.md | 4 +++
CUSTOM-CONTROLS.md | 8 ++---
DEVICES.md | 26 ++++++++------
JARCRASHED.md | 3 ++
JAVARUNTIMES.md | 9 +++++
JAVAVERSION.md | 7 ++++
JIT.md | 41 +++++++++++++++------
MODCONFLICT.md | 17 +++++++++
MODCRASHING.md | 2 ++
MODNOTSHOWINGUP.md | 3 ++
PROBLEMATIC-MODS-COMMON-FIXES.md | 62 ++++++++++++++++++++++++++++++++
RENDERERS.md | 28 +++++++--------
ROADMAP.md | 1 -
RPWORLDNOTSHOWINGUP.md | 21 +++++++++++
ZINKNOTWORKING.md | 10 ++++++
20 files changed, 268 insertions(+), 50 deletions(-)
create mode 100644 CANTFINDLOG.md
create mode 100644 CANTFINDMINECRAFT.md
create mode 100644 CANTLOGIN.md
create mode 100644 CRASHES.md
create mode 100644 JARCRASHED.md
create mode 100644 JAVARUNTIMES.md
create mode 100644 JAVAVERSION.md
create mode 100644 MODCONFLICT.md
create mode 100644 MODCRASHING.md
create mode 100644 MODNOTSHOWINGUP.md
create mode 100644 PROBLEMATIC-MODS-COMMON-FIXES.md
delete mode 100644 ROADMAP.md
create mode 100644 RPWORLDNOTSHOWINGUP.md
create mode 100644 ZINKNOTWORKING.md
diff --git a/.vuepress/config.js b/.vuepress/config.js
index 5b5cc5b8..f2b5d423 100644
--- a/.vuepress/config.js
+++ b/.vuepress/config.js
@@ -111,17 +111,29 @@ module.exports = {
collapsable: true, // Don't allow collapsing
sidebarDepth: 1,
children: [
- 'PARSINGERROR', // "Error while parsing the package" error fix
- 'REFUSALOFINSTALL', // "App not installed" error fix (very uncommon)
- '32BIT', // Platform and performance limitations (32bit)
- 'NOTCHFIX', // Pojav's notch-detection system on crap chinese spinoff phones
- 'FFMPEG', // Setting up FFMPEG, for Replay Mod
- 'ZINK', // What's Zink, and why it's not what you think
+ 'PARSINGERROR', // "Error while parsing the package" error fix.
+ 'REFUSALOFINSTALL', // "App not installed" error fix. (very uncommon)
+ 'CANTFINDLOG', // Can't find the log file. (non-root)
+ 'CANTFINDMINECRAFT', // Can't find .minecraft (non-root)
+ 'ZINKNOTWORKING', // Zink doesn't work.
+ 'MODCRASHING', // Installing any mod results in a crash.
+ 'MODNOTSHOWINGUP', // My mods don't show up in-game.
+ 'JAVARUNTIMES', // Installing Java runtimes manually.
+ 'JARCRASHED', // Crash when executing a jar.
+ '32BIT', // Platform and performance limitations. (32bit)
+ 'NOTCHFIX', // Pojav's notch-detection system on crap chinese spinoff phones.
+ 'FFMPEG', // Setting up FFMPEG, for Replay Mod.
+ 'ZINK', // What's Zink, and why it's not what you think.
'SHADERS', // Look what we got here.
'RENDERERS', // I have no idea what they do and why PojavLauncher needs it.
]
},
// FAQ that applies to both platforms goes here
+ 'RPWORLDNOTSHOWINGUP', // Resource pack or world doesn't show up.
+ 'CRASHES', // Random crashes during gameplay.
+ 'MODCONFLICT', // I have a mod conflict.
+ 'JAVAVERSION', // Which Java version to use?
+ 'CANTLOGIN', // Can't log in.
]
},
@@ -133,6 +145,7 @@ module.exports = {
'OPTIMIZATION', // Optimizing the game
'CUSTOM-MC', // Custom Minecraft!
'MODPACKS', // Everything you need to know about Modpacks support
+ 'PROBLEMATIC-MODS-COMMON-FIXES', // List of available fixes for popular modpacks
'ENV-VARS', // Using environment variables
'JAVA-ARGS', // Adding custom Java arguments
]
@@ -151,7 +164,6 @@ module.exports = {
'DEVICES', // Supported Devices
'MCVERS', // Supported Minecraft Versions
'MODS-UNSUPPORTED', // Unsupported Mods
- 'ROADMAP', // The road ahead for PojavLauncher
]
},
diff --git a/ABOUTPOJAV.md b/ABOUTPOJAV.md
index 6a75c41b..166b6ce1 100644
--- a/ABOUTPOJAV.md
+++ b/ABOUTPOJAV.md
@@ -31,7 +31,7 @@ PojavLauncher also uses the following third-party components:
* [pro-grade](https://github.com/pro-grade/pro-grade) (Java sandboxing security manager): [Apache License 2.0](https://github.com/pro-grade/pro-grade/blob/master/LICENSE.txt).
* [xHook](https://github.com/iqiyi/xHook) (Used for exit code trapping): [MIT and BSD-style licenses](https://github.com/iqiyi/xHook/blob/master/LICENSE).
* [libepoxy](https://github.com/anholt/libepoxy): [MIT License](https://github.com/anholt/libepoxy/blob/master/COPYING).
-* [virglrenderer](https://github.com/PojavLauncherTeam/virglrenderer): [MIT License](https://gitlab.freedesktop.org/virgl/virglrenderer/-/blob/master/COPYING).
+* [Zink](https://github.com/PojavLauncherTeam/osmesa-zink-builder): MIT License.
* [Apache Commons](https://commons.apache.org): [Apache License 2.0](http://www.apache.org/licenses/LICENSE-2.0.txt).
* [jsr305](https://code.google.com/p/jsr-305): [3-Clause BSD License](http://opensource.org/licenses/BSD-3-Clause).
* [org.json](https://github.com/stleary/JSON-java): [The JSON License](https://www.json.org/license.html).
@@ -49,4 +49,4 @@ PojavLauncher also uses the following third-party components:
* Thanks to [@Diatrus](https://github.com/Diatrus) for helping make this a reality in the beginning.
* Thanks to [MacStadium](https://macstadium.com) for providing the hardware needed to help PojavLauncher iOS go further.
-
\ No newline at end of file
+
diff --git a/CANTFINDLOG.md b/CANTFINDLOG.md
new file mode 100644
index 00000000..ee721002
--- /dev/null
+++ b/CANTFINDLOG.md
@@ -0,0 +1,18 @@
+# Can't find the log file (non-root)
+There are mutiple ways to do this. Usually, pressing the **Share log file** button is enough.
+
+## Android 10 and newer
+
+ **/storage/emulated/0/Android/data/net.kdt.pojavlaunch/files/latestlog.txt**
+
+1. Install [Files by Marc apps & software](https://play.google.com/store/apps/details?id=com.marc.files) from Play Store.
+2. Press the 3 lines in the top left corner → PojavLauncher → latestlog.txt
+
+If PojavLauncher does not appear in the 3 lines menu, try closing (or opening) Pojav. If that doesn't work, try restarting your phone.
+You can also use [ZArchiver](https://play.google.com/store/apps/details?id=ru.zdevs.zarchiver) (or [MiXplorer](https://mixplorer.com/)) with [Shizuku](https://play.google.com/store/apps/details?id=moe.shizuku.privileged.api&hl=en_US) to access it.
+
+## Android 9 and older
+
+ **/storage/emulated/0/games/PojavLauncher/latestlog.txt**
+
+All file managers can access this directory. [ZArchiver](https://play.google.com/store/apps/details?id=ru.zdevs.zarchiver) and [MiXplorer](https://mixplorer.com/) are recommended.
diff --git a/CANTFINDMINECRAFT.md b/CANTFINDMINECRAFT.md
new file mode 100644
index 00000000..5fb3867c
--- /dev/null
+++ b/CANTFINDMINECRAFT.md
@@ -0,0 +1,20 @@
+# Can't find .minecraft (non-root)
+As with the log file, there are mutiple ways to do this.
+
+## Android 10 and newer
+
+ **/storage/emulated/0/Android/data/net.kdt.pojavlaunch/files/.minecraft**
+
+1. Install [Files by Marc apps & software](https://play.google.com/store/apps/details?id=com.marc.files) from Play Store.
+2. Press the 3 dots in the top right corner → **Show hidden files**
+3. Press the 3 lines in the top left corner → PojavLauncher → .minecraft
+
+If PojavLauncher does not appear in the 3 lines menu, try closing (or opening) Pojav. If that doesn't work, try restarting your phone.
+You can also use [ZArchiver](https://play.google.com/store/apps/details?id=ru.zdevs.zarchiver) (or [MiXplorer](https://mixplorer.com/)) with [Shizuku](https://play.google.com/store/apps/details?id=moe.shizuku.privileged.api&hl=en_US) to access it.
+
+
+## Android 9 and older
+
+ **/storage/emulated/0/games/PojavLauncher/.minecraft**
+
+All file managers can access this directory. [ZArchiver](https://play.google.com/store/apps/details?id=ru.zdevs.zarchiver) and [MiXplorer](https://mixplorer.com/) are recommended.
diff --git a/CANTLOGIN.md b/CANTLOGIN.md
new file mode 100644
index 00000000..f4a8740c
--- /dev/null
+++ b/CANTLOGIN.md
@@ -0,0 +1,8 @@
+# Can't log in
+
+To fix your issues with login, try logging into minecraft.net first, sometimes just logging into the site fixes the issue. If that does not fix it, check these things:
+
+a) you must own Minecraft: Java Edition
+b) you must have a username set (check this if you are using Xbox Game Pass)
+c) your account should not be a child member of a family, playing Minecraft like this only works on the official Minecraft Launcher for PC.
+d) if the error is different and links you somewhere, try following any steps on the site it links you to
diff --git a/CRASHES.md b/CRASHES.md
new file mode 100644
index 00000000..f9e68a3f
--- /dev/null
+++ b/CRASHES.md
@@ -0,0 +1,4 @@
+# Random crashes during gameplay
+Make sure you aren't getting the warning due to too much allocated RAM. Even if you are close to the limit but not breaking it, RAM allocation might still be the cause of the crash. Try allocating 100-250MB less than the maximum, depending on your device. Keep in mind that when using big modpacks, you might also be crashing because you don't have enough allocated memory (that's if you see `java.lang.OutOfMemoryError` in your log file).
+
+Highest RAM allocation doesn't mean highest performance. Your might usually gain tens of FPS by figuring out which RAM allocation setting runs Pojav the best on your device.
diff --git a/CUSTOM-CONTROLS.md b/CUSTOM-CONTROLS.md
index e716514c..d317f5e4 100644
--- a/CUSTOM-CONTROLS.md
+++ b/CUSTOM-CONTROLS.md
@@ -32,19 +32,19 @@
To start editing your controlmap in iOS, head to top-left and press the sidebar. (shown in image)
-
+
Press the custom controls button.
-
+
After that, long press anywhere for more options.
-
+
Now you will get a pop-up with the following options:
-
+
1- Exits the controlmap editor.
diff --git a/DEVICES.md b/DEVICES.md
index d9a7360a..7d06c672 100644
--- a/DEVICES.md
+++ b/DEVICES.md
@@ -1,17 +1,21 @@
# Device requirements
-- **Minimum** means 30 or more average FPS on 1.7.10 with [OptiFine](https://optifine.net/downloads) installed at lowest settings.
-- **Recommended** means 60 or more average FPS on 1.19.4 with [OptiFine](https://optifine.net/downloads) installed at lowest settings.
+- **Minimum** means 60 or more average FPS on 1.12.2 with [OptiFine](https://optifine.net/downloads) installed at lowest settings.
+- **Recommended** means 60 or more average FPS on 1.21.1 with [OptiFine](https://optifine.net/downloads) installed with the following settings:
+- 10 Render Distance
+- Smooth Lighting
+- All animations
+- 75% Resolution
## Android
### Minimum requirements:
-- Qualcomm Snapdragon 400 (or equivalent)
+- Qualcomm Snapdragon 460 (or equivalent)
- Android 5.0
- 1GB RAM
### Recommended requirements:
-- Qualcomm Snapdragon 820 (or equivalent) with Vulkan API support
+- Qualcomm Snapdragon 855 (or equivalent)
- Android 8.0 and newer
-- 4GB RAM or higher (the more the merrier)
+- 6GB RAM or higher
### ChromeOS
- Chromebooks have very similar system requirements, however Android version does not matter, as long as you can install Android apps.
@@ -19,12 +23,12 @@
## iOS
### Minimum requirements:
-- Apple A8 SoC
- - The Apple A7 SoC is losing support in PojavLauncher 2.3.
-- iOS 14
-- 1GB RAM
+- Apple A8/A8X SoC
+- iOS 14/iPadOS 14 or higher
+ - iOS/iPadOS 12 & 13 is losing support in PojavLauncher 2.3.
+- 2GB RAM
### Recommended requirements:
- Apple A14/A12X Bionic SoC
-- iOS 14
-- 4GB RAM or higher
+- iOS/iPadOS 14 or higher
+- 6GB RAM or higher
diff --git a/JARCRASHED.md b/JARCRASHED.md
new file mode 100644
index 00000000..739d112b
--- /dev/null
+++ b/JARCRASHED.md
@@ -0,0 +1,3 @@
+# Crash when executing a jar
+
+This is not how it works, mods have to be installed into the **.minecraft/mods** directory. Mod loaders (e. g. Forge and Fabric) and some mods like OptiFine and Iris have an integrated installer, this is not the case for the absolute majority of mods, meaning they don't have any GUI that would run when opening them with the Execute .jar button in the launcher. If you don't know how to get into the **.minecraft** directory, please read the article on how to access it.
diff --git a/JAVARUNTIMES.md b/JAVARUNTIMES.md
new file mode 100644
index 00000000..f8f1e858
--- /dev/null
+++ b/JAVARUNTIMES.md
@@ -0,0 +1,9 @@
+# Installing Java runtimes manually
+
+If you for whatever reason decided to install `app-debug-noruntime` or you want to update for whatever reason, here's how you do it.
+
+1. Go to the **android-openjdk-build-multiarch** repo on GitHub, pick the branch you want (e. g. buildjre8 or buildjre17-21.)
+2. Log into GitHub, else you won't be able to download the runtime.
+3. Click on the name of the action, then download the `pojav` version of the runtime (e. g. `jre17-pojav`). Do not download jdk, your game might crash with it.
+4. Extract the zip with your file manager. [ZArchiver](https://play.google.com/store/apps/details?id=ru.zdevs.zarchiver) and [MiXplorer](https://mixplorer.com/) are recommended.
+5. Open Pojav and go to Settings → Java Tweaks → Runtime Manager → Add new, then select the .tar.xz file you just extracted from the zip.
diff --git a/JAVAVERSION.md b/JAVAVERSION.md
new file mode 100644
index 00000000..1972ab78
--- /dev/null
+++ b/JAVAVERSION.md
@@ -0,0 +1,7 @@
+# Which Java version to use?
+
+Generally, this is what you want to know:
+ - Minecraft 1.17 and newer: Java 21
+ - Minecraft 1.16.5 and older: Java 8
+
+Note: some modded Minecraft versions require a different Java runtime than normal (e. g. Cursed Fabric or Babric for Minecraft b1.7.3). Others might work even when using a different runtime (e. g. Fabric for Minecraft 1.16.5 allows using Java 17). However, some mods, notably OptiFabric, might stop working altogether.
diff --git a/JIT.md b/JIT.md
index fdb9d438..aaa66374 100644
--- a/JIT.md
+++ b/JIT.md
@@ -21,23 +21,42 @@ If you sideload normally, you will need to enable JIT in some way. The most comm
The only downside to this method is that you are required to be connected to a WiFi network in order to enable JIT. (*)
-(*) - Enabling JIT on iOS 17.x & iOS 18 betas (at the moment) can only be enabled through AltJIT (macOS only) or SideJITServer, which requires a computer (Windows, MacOS and Linux only). This is because these methods utilize pymobiledevice3 to enable JIT due to changes in iOS.
+(*) - Enabling JIT on iOS 17.0.1+ & iOS 18 betas (at the moment) can only be enabled through AltJIT (macOS only) or SideJITServer, which requires a computer (Windows, MacOS and Linux only). This is because these methods utilize pymobiledevice3 to enable JIT due to changes in iOS.
-Methods to enable JIT:
-- [AltStore AltJIT](https://faq.altstore.io/how-to-use-altstore/altjit) (*)
+## What are the methods to enable JIT?
-- [Jitterbug](https://github.com/osy/Jitterbug/tree/main/Jitterbug) (^)
+The methods to enable JIT can be found [here](https://github.com/ItAnthon/JIT-on-iOS).
-- [SideStore SideJIT](https://docs.sidestore.io/docs/faq/#:~:text=Can%20I%20activate,selecting%20'Enable%20JIT') (^)
+Methods not listed here are not confirmed or recommended by us for use with PojavLauncher.
-- [SideStore Anisette](https://docs.sidestore.io/docs/intro) (^)
+## So how do I enable JIT?
-- [SideJITServer](https://github.com/nythepegasus/SideJITServer) (!)
+- [TrollStore Lite](https://havoc.app/package/trollstorelite) (!)
-(*) - AltJIT for iOS 17.x & iOS 18 betas only works on macOS. Requires pymobiledevice3.
+- [TrollStore](https://ios.cfw.guide/installing-trollstore) (@)
-(^) - Does not work for iOS 17.x & iOS 18 betas, as enabling JIT will be done with pymobiledevice3.
+- [AltStore AltJIT](https://faq.altstore.io/how-to-use-altstore/altjit) (#)
-(!) - Does not work for iOS 16.x or below, use the other methods listed above to enable JIT. This method is meant for iOS 17.x & iOS 18 betas.
+- [Jitterbug](https://github.com/osy/Jitterbug/tree/main/Jitterbug) ($)
-Methods not listed here are not confirmed or recommended by us for use with PojavLauncher.
+- [SideStore](https://docs.sidestore.io/docs/faq#can-i-activate-jit) ($)
+
+- [SideJITServer](https://github.com/nythepegasus/SideJITServer) (%)
+
+(!) - Limited to Jailbroken devices only. (JIT is granted by the Jailbreak itself)
+
+(@) - Limited to devices with the CoreTrust bug. (iOS 14.0 - iOS 16.6.1 & iOS 17.0)
+
+(#) - AltJIT for iOS 17.x & iOS 18 betas only works on macOS. Requires pymobiledevice3.
+
+($) - Does not work for iOS 17.x & iOS 18 betas, as enabling JIT will be done with pymobiledevice3.
+
+(%) - Does not work for iOS 16.x or below, use the other methods listed above to enable JIT. This method is meant for iOS 17.x & iOS 18 betas.
+
+## Methods coming Soon:
+
+- JITStreamer 2.0 (^)
+
+- UTM SE (^)
+
+(^) - iOS 17.4+ Only
diff --git a/MODCONFLICT.md b/MODCONFLICT.md
new file mode 100644
index 00000000..17b6ff1f
--- /dev/null
+++ b/MODCONFLICT.md
@@ -0,0 +1,17 @@
+# I have a mod conflict
+Try removing the mods by half:
+1. Remove half of the mods (including mods that depend on other mods from the first half)
+2. If you don't crash, put in half of the mods you just removed, then continue adding up. If you do crash, remove half of the mods you have now.
+3. Figure out which mod is causing the issue.
+
+## We don't know what doesn't work means
+
+"Doesn't work" does not actually mean anything, explain more thoroughly. For example:
+
+**Wrong:** My game crashes please help!11!1
+**Correct:** After I installed OptiFine, my game crashes, here's the latestlog.txt. Please tell me which mod it's conflicting with.
+
+**Wrong:** My resource pack doesn't show up!11!1
+**Correct:** I installed a resource pack from (link) and I have no idea how to properly install it, it doesn't show up in-game. Do I leave it as a zip, extract it or what do I do? Here's a video of how it looks.
+
+If you don't really know what you are doing, the best you can do is just send the log file (latestlog.txt), you don't have to say anything about it.
diff --git a/MODCRASHING.md b/MODCRASHING.md
new file mode 100644
index 00000000..852e4133
--- /dev/null
+++ b/MODCRASHING.md
@@ -0,0 +1,2 @@
+# Installing any mod results in a crash
+Please check the log file. In case you find yourself getting "Permission denied" on all of your files, please do not cut the mods, copy them instead.
diff --git a/MODNOTSHOWINGUP.md b/MODNOTSHOWINGUP.md
new file mode 100644
index 00000000..c3e4707a
--- /dev/null
+++ b/MODNOTSHOWINGUP.md
@@ -0,0 +1,3 @@
+# My mods don't show up in-game
+1. Please check the log file. In case you find yourself getting "Permission denied" on all of your files, please do not cut the mods, copy them instead.
+2. If a custom path is set in Profile options (pencil button), make sure your mods are in your custom path.
diff --git a/PROBLEMATIC-MODS-COMMON-FIXES.md b/PROBLEMATIC-MODS-COMMON-FIXES.md
new file mode 100644
index 00000000..8fbe1afa
--- /dev/null
+++ b/PROBLEMATIC-MODS-COMMON-FIXES.md
@@ -0,0 +1,62 @@
+# RLCraft
+
+### In order to run RLCraft you have to remove these mods:
+
+* Custom Main Menu
+
+* Fancy Block Particles
+
+* Dynamic Surroundings
+
+* Sound Filters
+
+**credits to [kasrarouhi](https://github.com/kasrarouhi)**
+
+# Better Than Wolves (BTW)
+
+## Android
+
+### WARNING: This is the short version of the guide. It is recommended to use the [full version.](https://www.mediafire.com/file/3ex8b12pvwb2g9m/INSTALL_BTW_updated_v1.2.pdf/file)
+
+1. Download Acode Editor, ZArchiver and RAR from the Google Play Store if you haven’t already.
+
+2. Download the [BTW Installer](https://github.com/BTW-Community/legacy-fabric-installer/releases/tag/1.1.1-btw).
+
+3. Go into PojavLauncher, execute the .jar and install it.
+
+4. Launch the game (should crash that’s normal).
+
+5. Check the .jar in "***.minecraft/versions/cursed-fabric-btw-version-name***". If it doesn’t have 5MB, it is corrupted. You must replace it with the vanilla 1.5.2 .jar and name it "***cursed-fabric-btw-version-name.jar***".
+
+6. **The long guide explains it better (with screenshots).**
+
+ Create a new 1.5.2-custom version by copying the vanilla version and renaming the files inside that directory, then remove `client` downloads, change the `id` to 1.5.2-custom, change `mainClass` from `net.minecraft.launchwrapper.Launch` to `net.minecraft.client.Minecraft`, then remove the `asm-all` dependency downloads.
+
+7. **The long guide explains it better (with screenshots).**
+
+ To fix your username, add `"minecraftArguments": "--assetsDir ${assets_root} --username $
+{auth_player_name} --session ${auth_session}",` to your ***cursed-fabric-loader-btw-version-name.json***.
+
+8. Download the [BTW Mod](https://github.com/BTW-Community/Cursed-BTW/releases/tag/v0.5-beta-v2.1.1) .jar and put the .jar in the mods folder.
+
+9. Now we have to patch a Cursed Fabric .jar that's located in "***/.minecraft/libraries/com/github/minecraft-cursed-legacy/cursed-fabric-loader/btw-version-name/cursed-fabric-loader-btw-version-name.jar***".
+
+ Download this file: [AppletMain](https://github.com/ItAnthon/AppletMain-Patch) not running into your downloads folder, then grab the patched AppletMain file from here and copy it into this location: "***/net/fabricmc/loader/entrypoint/applet/AppletMain.class***" (inside of the unpatched .jar file using RAR).
+
+10. Grab the patched .jar file and replace the old one inside of "***/.minecraft/libraries/com/github/minecraft-cursed-legacy/cursed-fabric-loader/btw-version-name/cursed-fabric-loader-btw-version-name.jar***". Please be sure that it has the same name as the original .jar file.
+
+11. Done, launch the game.
+
+**credits to [GaucovyAero](https://github.com/gaucovyaero/) and [ItAnthon](https://github.com/ItAnthon)**
+
+
+# Valkyrien Skies 2
+## Android
+
+As of 2024/09/09, there is no way to run VS2 on Android in Singleplayer, so your only option is to join a VS2 server. You can host a server capable of running VS2 on Android inside Termux, but it's not very easy to setup.
+
+There's a script created by [sa1672ndo](https://github.com/sa1672ndo) that automates this entire process to make the installation easier.
+
+The script can be found [here](https://github.com/sa1672ndo/vs2termux).
+
+**credits to [sa1672ndo](https://github.com/sa1672ndo)**
diff --git a/RENDERERS.md b/RENDERERS.md
index 85513aa4..bf08b1b8 100644
--- a/RENDERERS.md
+++ b/RENDERERS.md
@@ -1,25 +1,25 @@
# Renderers
Minecraft runs on OpenGL, and mobile devices generally only support OpenGL ES (GLES). And since Minecraft won't run on GLES, we have to use renderers as compatibility layers between OpenGL ES and OpenGL.
+> All of the following renderers were tested using the same environment; Minecraft 1.21.1 with Optifine, 8 chunks, running on a Snapdragon 778g at 80% resolution scale, with Fast graphics and smooth lighting.
## Holy GL4ES
-- Designed for performance, Holy GL4ES is the default renderer in PojavLauncher and should be used in almost all scenrarios.
+- Optimized for performance, Holy GL4ES is the default renderer in PojavLauncher and should be used in almost all scenrarios.
- Supports OpenGL 2.1 and has shader converting capabilities, thus makes up for about 1/8 of the OpenGL 3.x standard.
- Works on all versions of vanilla Minecraft.
-
-### A screenshot of Holy GL4ES running Minecraft 1.19.4
-
-
+### A screenshot of Holy GL4ES running Minecraft 1.21.1
+
## ANGLE
-- A bit slower than Holy GL4ES, runs on Vulkan. Should be used only in specific cases, where one can't load a server resource pack or a mod does not run because of missing OpenGL extensions.
+- Slower than Holy GL4ES(*), runs on Vulkan. Should be used only in specific cases, where a server resource pack or a mod fails to run due to missing OpenGL extensions.
- Supports OpenGL 3.2 only.
- Only works on Minecraft 1.17+
+> On iOS devices, ANGLE can provide faster performance than Holy GL4ES.
-### A screenshot of ANGLE running Minecraft 1.19.4
-
+### A screenshot of ANGLE running Minecraft 1.21.1
+
-## virglrenderer
-- Very slow, will soon be removed. It's only use cases are mods that don't run because of missing OpenGL extensions and running shaders.
-- Supports OpenGL 4.3.
-- Works on Minecraft 1.7+, can be extremely buggy.
+## Zink
+- Slow. It's only useful for mods that don't run due to missing OpenGL extensions and for running shaders.
+- Supports OpenGL 4.5 on Adreno GPUs with Turnip, and OpenGL 3.3 on Mali GPUs. Adreno GPUs without Turnip **will** experience significant bugs or crashes when using Zink.
+- Works on all vanilla versions of Minecraft.
-### A screenshot of virglrenderer running Minecraft 1.12.2
-
+### A screenshot of Zink running Minecraft 1.21.1
+
diff --git a/ROADMAP.md b/ROADMAP.md
deleted file mode 100644
index 506fde65..00000000
--- a/ROADMAP.md
+++ /dev/null
@@ -1 +0,0 @@
-# The road ahead for PojavLauncher
\ No newline at end of file
diff --git a/RPWORLDNOTSHOWINGUP.md b/RPWORLDNOTSHOWINGUP.md
new file mode 100644
index 00000000..bbfd171d
--- /dev/null
+++ b/RPWORLDNOTSHOWINGUP.md
@@ -0,0 +1,21 @@
+# Resource pack or world doesn't show up
+Read carefully and check the structure of the archives (zips) or folders (directories), make sure there are no additional ones.
+
+## Resource pack
+**Wrong:**
+pack.zip → pack (folder) → pack.mcmeta
+pack (folder) → pack (folder) → pack.mcmeta
+
+**Correct:**
+pack.zip → pack.mcmeta
+pack (folder) → pack.mcmeta
+
+## World
+The world cannot be zipped inside the saves folder.
+
+**Wrong:**
+ world.zip → level.dat
+ world.zip → world (directory) → level.dat
+
+**Correct:**
+ world (directory) → level.dat
diff --git a/ZINKNOTWORKING.md b/ZINKNOTWORKING.md
new file mode 100644
index 00000000..c646ce6b
--- /dev/null
+++ b/ZINKNOTWORKING.md
@@ -0,0 +1,10 @@
+# Zink doesn't work
+If Zink worked for you before the `foxglove` update, this might get it running on your device. It doesn't help on devices which don't fulfill the base Zink requirements.
+
+ **/storage/emulated/0/Android/data/net.kdt.pojavlaunch/files/custom_env.txt**
+ (if this file does not exist, create it)
+
+```
+MESA_GL_VERSION_OVERRIDE=4.6
+MESA_GLSL_VERSION_OVERRIDE=460
+```