Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Bundle of changes, new FAQ stuff aswell #198

Merged
merged 38 commits into from
Sep 25, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
38 commits
Select commit Hold shift + click to select a range
e73cf9d
added PROBLEMATIC_MODS_COMMON_FIXES
Dev1ss0 Aug 29, 2024
4d16c2b
Create PROBLEMATIC-MODS-COMMON-FIXES.md
Dev1ss0 Aug 29, 2024
a484c81
Update PROBLEMATIC-MODS-COMMON-FIXES.md
Dev1ss0 Aug 29, 2024
962b364
Update PROBLEMATIC-MODS-COMMON-FIXES.md
Dev1ss0 Aug 29, 2024
a6623cf
Update PROBLEMATIC-MODS-COMMON-FIXES.md
GaucovyAero Sep 9, 2024
6d7f755
Update PROBLEMATIC-MODS-COMMON-FIXES.md
ItAnthon Sep 9, 2024
77870bd
Update JIT.md
ItAnthon Sep 11, 2024
c817f8e
Removed ROADMAP.md
Dev1ss0 Sep 22, 2024
261496d
Delete ROADMAP.md
Dev1ss0 Sep 22, 2024
c7470ef
Update RENDERERS.md
whal-whales Sep 23, 2024
8188b4a
Update CUSTOM-CONTROLS.md
whal-whales Sep 23, 2024
db712bc
Create CANT-FIND-LOG.md
Dev1ss0 Sep 24, 2024
1f4b5ce
Rename CANT-FIND-LOG.md to CANTFINDLOG.md
Dev1ss0 Sep 24, 2024
3bae6f6
Update CANTFINDLOG.md
Dev1ss0 Sep 24, 2024
dfc5af1
Create CANTFINDMINECRAFT.md
Dev1ss0 Sep 24, 2024
5cf249e
Create ZINKNOTWORKING.md
Dev1ss0 Sep 24, 2024
25ef78c
Create MODCRASHING.md
Dev1ss0 Sep 24, 2024
6038b30
Create MODNOTSHOWINGUP.md
Dev1ss0 Sep 24, 2024
37d2a81
Create RPWORLDNOTSHOWINGUP.md
Dev1ss0 Sep 24, 2024
1e81152
Create CRASHES.md
Dev1ss0 Sep 24, 2024
6f10c69
Create MODCONFLICT.md
Dev1ss0 Sep 24, 2024
5e74930
Create JAVARUNTIMES.md
Dev1ss0 Sep 24, 2024
03182cb
Create JAVAVERSION.md
Dev1ss0 Sep 24, 2024
326b920
Create JARCRASHED.md
Dev1ss0 Sep 24, 2024
466bfe5
Create CANTLOGIN.md
Dev1ss0 Sep 24, 2024
0a16220
Update config.js -Credit: @GaucovyAero
Dev1ss0 Sep 24, 2024
e3cd1ca
Update JAVAVERSION.md
Dev1ss0 Sep 25, 2024
49cc67c
Updat
ItAnthon Sep 25, 2024
bb0e05e
bluelights phone is now the minimum
ItAnthon Sep 25, 2024
c85d076
Update DEVICES.md
whal-whales Sep 25, 2024
d9cdc22
Update ABOUTPOJAV.md
whal-whales Sep 25, 2024
be0b06d
Update DEVICES.md
ItAnthon Sep 25, 2024
f19478c
Update DEVICES.md
ItAnthon Sep 25, 2024
4df7ada
Update DEVICES.md
ItAnthon Sep 25, 2024
a5dbcc7
Update DEVICES.md
ItAnthon Sep 25, 2024
8d7d040
Update DEVICES.md
ItAnthon Sep 25, 2024
863c823
Update config.js
Dev1ss0 Sep 25, 2024
88b8488
Update CUSTOM-CONTROLS.md
whal-whales Sep 25, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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
Loading