Skip to content

Commit

Permalink
Bundle of changes, new FAQ stuff aswell (#198)
Browse files Browse the repository at this point in the history
* added PROBLEMATIC_MODS_COMMON_FIXES

Signed-off-by: Dev1ss0 <[email protected]>

* Create PROBLEMATIC-MODS-COMMON-FIXES.md

Signed-off-by: Dev1ss0 <[email protected]>

* Update PROBLEMATIC-MODS-COMMON-FIXES.md

Signed-off-by: Dev1ss0 <[email protected]>

* Update PROBLEMATIC-MODS-COMMON-FIXES.md

Signed-off-by: Dev1ss0 <[email protected]>

* Update PROBLEMATIC-MODS-COMMON-FIXES.md

added a few things, edited some other ones

Signed-off-by: GaucovyAero <[email protected]>

* Update PROBLEMATIC-MODS-COMMON-FIXES.md

hosted my own repo to host the patched AppletMain.class file

Signed-off-by: ItAnthon <[email protected]>

* 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 <[email protected]>

* Removed ROADMAP.md

Signed-off-by: Dev1ss0 <[email protected]>

* Delete ROADMAP.md

Signed-off-by: Dev1ss0 <[email protected]>

* Update RENDERERS.md

chat did I cook

Signed-off-by: whal-whales <[email protected]>

* Update CUSTOM-CONTROLS.md

Signed-off-by: whal-whales <[email protected]>

* Create CANT-FIND-LOG.md

Signed-off-by: Dev1ss0 <[email protected]>

* Rename CANT-FIND-LOG.md to CANTFINDLOG.md

Signed-off-by: Dev1ss0 <[email protected]>

* Update CANTFINDLOG.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create CANTFINDMINECRAFT.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create ZINKNOTWORKING.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create MODCRASHING.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create MODNOTSHOWINGUP.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create RPWORLDNOTSHOWINGUP.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create CRASHES.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create MODCONFLICT.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create JAVARUNTIMES.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create JAVAVERSION.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create JARCRASHED.md

Signed-off-by: Dev1ss0 <[email protected]>

* Create CANTLOGIN.md

Signed-off-by: Dev1ss0 <[email protected]>

* Update config.js -Credit: @GaucovyAero

Signed-off-by: Dev1ss0 <[email protected]>

* Update JAVAVERSION.md

Thanks Bel!

Signed-off-by: Dev1ss0 <[email protected]>

* Updat

Signed-off-by: ItAnthon <[email protected]>

* bluelights phone is now the minimum 

lol 

Signed-off-by: ItAnthon <[email protected]>

* Update DEVICES.md

Signed-off-by: whal-whales <[email protected]>

* Update ABOUTPOJAV.md

changed virglrenderer to zink

Signed-off-by: whal-whales <[email protected]>

* Update DEVICES.md

last minute change

Signed-off-by: ItAnthon <[email protected]>

* Update DEVICES.md

wrong number sorry 

Signed-off-by: ItAnthon <[email protected]>

* Update DEVICES.md

technically 2.3 drops iOS 12/13 after 3 weeks

Signed-off-by: ItAnthon <[email protected]>

* Update DEVICES.md

the minimum chipsets have 2 gb ram so i changed it 

Signed-off-by: ItAnthon <[email protected]>

* 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 <[email protected]>

* Update config.js

Signed-off-by: Dev1ss0 <[email protected]>

* Update CUSTOM-CONTROLS.md

Signed-off-by: whal-whales <[email protected]>

---------

Signed-off-by: Dev1ss0 <[email protected]>
Signed-off-by: GaucovyAero <[email protected]>
Signed-off-by: ItAnthon <[email protected]>
Signed-off-by: whal-whales <[email protected]>
Co-authored-by: GaucovyAero <[email protected]>
Co-authored-by: ItAnthon <[email protected]>
Co-authored-by: whal-whales <[email protected]>
  • Loading branch information
4 people authored Sep 25, 2024
1 parent 76ce47f commit 00922ed
Show file tree
Hide file tree
Showing 20 changed files with 268 additions and 50 deletions.
26 changes: 19 additions & 7 deletions .vuepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -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.
]

},
Expand All @@ -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
]
Expand All @@ -151,7 +164,6 @@ module.exports = {
'DEVICES', // Supported Devices
'MCVERS', // Supported Minecraft Versions
'MODS-UNSUPPORTED', // Unsupported Mods
'ROADMAP', // The road ahead for PojavLauncher
]

},
Expand Down
4 changes: 2 additions & 2 deletions ABOUTPOJAV.md
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand All @@ -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.

![](https://user-images.githubusercontent.com/55281754/183129754-c3736bb9-d528-4af7-9351-a12b3be7549e.png)
![](https://user-images.githubusercontent.com/55281754/183129754-c3736bb9-d528-4af7-9351-a12b3be7549e.png)
18 changes: 18 additions & 0 deletions CANTFINDLOG.md
Original file line number Diff line number Diff line change
@@ -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.
20 changes: 20 additions & 0 deletions CANTFINDMINECRAFT.md
Original file line number Diff line number Diff line change
@@ -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.
8 changes: 8 additions & 0 deletions CANTLOGIN.md
Original file line number Diff line number Diff line change
@@ -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
4 changes: 4 additions & 0 deletions CRASHES.md
Original file line number Diff line number Diff line change
@@ -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.
8 changes: 4 additions & 4 deletions CUSTOM-CONTROLS.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,19 +32,19 @@

To start editing your controlmap in iOS, head to top-left and press the sidebar. (shown in image)

<img src="https://raw.githubusercontent.com/Dev1ss0/Dev1ss0.github.io/main/images/Actions/ios/IMG_3219.png" width=45% height=45%>
<img src="https://raw.githubusercontent.com/whal-whales/random-imgs-repo-for-stuff/refs/heads/main/IMG_3219.png" width=45% height=45%>

Press the custom controls button.

<img src="https://raw.githubusercontent.com/Dev1ss0/Dev1ss0.github.io/7d01c01011b0e135aac34849846a8fd48893ecbf/images/Actions/ios/IMG_3220.png" width=75% height=75%>
<img src="https://raw.githubusercontent.com/whal-whales/random-imgs-repo-for-stuff/refs/heads/main/IMG_3220-1.png" width=45% height=45%>

After that, long press anywhere for more options.

<img src="https://raw.githubusercontent.com/Dev1ss0/Dev1ss0.github.io/main/images/Actions/ios/IMG_3221.png" width=75% height=75%>
<img src="https://raw.githubusercontent.com/whal-whales/random-imgs-repo-for-stuff/refs/heads/main/IMG_3221.png" width=75% height=75%>

Now you will get a pop-up with the following options:

<img src="https://raw.githubusercontent.com/Dev1ss0/Dev1ss0.github.io/main/images/Actions/ios/IMG_3222.png" width=75% height=75%>
<img src="https://raw.githubusercontent.com/whal-whales/random-imgs-repo-for-stuff/refs/heads/main/IMG_3222.png" width=75% height=75%>

1- Exits the controlmap editor.

Expand Down
26 changes: 15 additions & 11 deletions DEVICES.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,34 @@
# 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.

## 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
3 changes: 3 additions & 0 deletions JARCRASHED.md
Original file line number Diff line number Diff line change
@@ -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.
9 changes: 9 additions & 0 deletions JAVARUNTIMES.md
Original file line number Diff line number Diff line change
@@ -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.
7 changes: 7 additions & 0 deletions JAVAVERSION.md
Original file line number Diff line number Diff line change
@@ -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.
41 changes: 30 additions & 11 deletions JIT.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
17 changes: 17 additions & 0 deletions MODCONFLICT.md
Original file line number Diff line number Diff line change
@@ -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.
2 changes: 2 additions & 0 deletions MODCRASHING.md
Original file line number Diff line number Diff line change
@@ -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.
3 changes: 3 additions & 0 deletions MODNOTSHOWINGUP.md
Original file line number Diff line number Diff line change
@@ -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.
Loading

0 comments on commit 00922ed

Please sign in to comment.