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

Patch 1 #112

Open
wants to merge 8 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .vuepress/config.js
Original file line number Diff line number Diff line change
Expand Up @@ -170,7 +170,7 @@ module.exports = {

},
{
title: 'Recent Updates', // Category about recent developments
title: 'Legal Mumbo Jumbo', // Category about recent developments
collapsable: false,
sidebarDepth: 1,
children: [
Expand Down
34 changes: 17 additions & 17 deletions 32BIT.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
# PojavLauncher's 32-bit support
Most of you, Android users, who are reading this now, won't be bothered by this documentation, but for the poor souls who have a 32-bit device, let's press ~~L~~ F to pay respect to them.
Before ARM transitioned into the more-powerful, more-utilizing `arm64/aarch64` architecture; everyone was using `arm/aarch32`
We're not here to give you historical information of it, but feel free to read [this documentary about the ARM platform.](https://en.m.wikipedia.org/wiki/ARM_architecture_family)
**You may encounter issues while using PojavLauncher on 32-bit devices. Here's a list of stuff that's known to be problematic:**
## RAM Allocation
* **Real 32-bit devices (32-bit hardware and firmware), can't allocate more than 768MB of RAM to PojavLauncher. This can't be changed even if the device has more free RAM.**
* Examples of real 32-bit SoCs: Qualcomm Snapdragon 801, 800, 600, 400, S4, S3, S2, S1
* **64-bit devices limited to 32-bit firmware can't allocate more than ~1000MB of RAM. As said earlier, this can't be changed.**
* Examples of 64-bit SoCs limited to 32-bit firmware: MediaTek Helio G37, G35, G25, P35, P25, P23, P22
## Performance
Due to 32-bit's processing speed limit, Minecraft's performance is always compromised. Even with optimization mods installed, you may get big stutters even on lowest settings. Decreasing RAM Allocation may help performance in certain scenarios.
# PojavLauncher's 32-bit support
Most of you, Android users, who are reading this now, won't be bothered by this documentation, but for the poor souls who have a 32-bit device, let's press ~~L~~ F to pay respect to them.

Before ARM transitioned into the more-powerful, more-utilizing `arm64/aarch64` architecture; everyone was using `arm/aarch32`

We're not here to give you historical information of it, but feel free to read [this documentary about the ARM platform.](https://en.m.wikipedia.org/wiki/ARM_architecture_family)

**You may encounter issues while using PojavLauncher on 32-bit devices. Here's a list of stuff that's known to be problematic:**

## RAM Allocation
* **Real 32-bit devices (32-bit hardware and firmware), can't allocate more than 768MB of RAM to PojavLauncher. This can't be changed even if the device has more free RAM.**
* Examples of real 32-bit SoCs: Qualcomm Snapdragon 801, 800, 600, 400, S4, S3, S2, S1
* **64-bit devices limited to 32-bit firmware can't allocate more than ~1000MB of RAM. As said earlier, this can't be changed.**
* Examples of 64-bit SoCs limited to 32-bit firmware: MediaTek Helio G37, G35, G25, P35, P25, P23, P22

## Performance
Due to 32-bit's processing speed limit, Minecraft's performance is always compromised. Even with optimization mods installed, you may get big stutters even on lowest settings. Decreasing RAM Allocation may help performance in certain scenarios.
53 changes: 53 additions & 0 deletions ABOUTPOJAV.md.save
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
# PojavLauncher

### From the ashes of zhouwei's Boardwalk project comes PojavLauncher, a capable, fast, and open-source Minecraft: Java Edition launcher for Android and iOS.

PojavLauncher is based off of **zhouwei's Boardwalk** project, which brought Minecraft 1.13 to Android. Improved upon and revived by the team, PojavLauncher brings Boardwalk to new heights with more versions, more devices, and even iOS support.

Right now, you're looking at the PojavLauncher website, with information regarding the launcher and various guides on how to navigate, operate, and get to playing. Take a look around, there's more in store!

## Credits

PojavLauncher didn't just appear out of thin air, but was made possible by the following people!

[@PojavLauncherTeam](https://twitter.com/PLaunchTeam), which includes
* [@DuyKhanhTran](https://github.com/khanhduytran0), lead project founder and maintainer;
* [@artdeell](https://github.com/artdeell), Android maintainer;
* [@Mathias Bouley](https://github.com/Mathias-Boulay), Controls, Renderers;
* [@crystall1nedev](https://github.com/crystall1nedev), lead iOS maintainer;
* [@lunaveux](https://github.com/lunaveux), lead wiki maintainer

...and many more contributors to the [Android](https://github.com/PojavLauncherTeam/PojavLauncher/graphs/contributors) and [iOS](https://github.com/PojavLauncherTeam/PojavLauncher_iOS/graphs/contributors) repositories.

PojavLauncher also uses the following third-party components:

* [Boardwalk](https://github.com/zhuowei/Boardwalk) (JVM Launcher): Unknown License/[Apache License 2.0](https://github.com/zhuowei/Boardwalk/blob/master/LICENSE) or GNU GPLv2.
* [Caciocavallo](https://github.com/PojavLauncherTeam/caciocavallo): [GNU GPLv2 License](https://github.com/PojavLauncherTeam/caciocavallo/blob/master/LICENSE).
* Android Support Libraries: [Apache License 2.0](https://android.googlesource.com/platform/prebuilts/maven_repo/android/+/master/NOTICE.txt).
* [GL4ES](https://github.com/ptitSeb/gl4es): [MIT License](https://github.com/ptitSeb/gl4es/blob/master/LICENSE).<br>
* [OpenJDK](https://github.com/PojavLauncherTeam/openjdk-multiarch-jdk8u): [GNU GPLv2 License](https://openjdk.java.net/legal/gplv2+ce.html). On iOS, it was ported by [@Diatrus](https://twitter.com/diatrus)
* [LWJGL3](https://github.com/PojavLauncherTeam/lwjgl3): [BSD-3 License](https://github.com/LWJGL/lwjgl3/blob/master/LICENSE.md).
* [LWJGLX](https://github.com/PojavLauncherTeam/lwjglx) (LWJGL2 API compatibility layer for LWJGL3): unknown license.<br>
* [Mesa 3D Graphics Library](https://gitlab.freedesktop.org/mesa/mesa): [MIT License](https://docs.mesa3d.org/license.html).
* [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).
* [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).
* [MetalANGLE](https://github.com/kakashidinho/metalangle) by @kakashidinho and ANGLE team: [BSD License 2.0](https://github.com/kakashidinho/metalangle/blob/master/LICENSE).
* [MoltenVK](https://github.com/KhronosGroup/MoltenVK): [Apache 2.0 License](https://github.com/KhronosGroup/MoltenVK/blob/master/LICENSE).
* [Alderis](https://github.com/hbang/Alderis) (color picker for iOS < 14): [Apache 2.0 License](https://github.com/hbang/Alderis/blob/master/LICENSE.md).
* [DBNumberedSlider](https://github.com/immago/DBNumberedSlider): [Apache 2.0 License](https://github.com/immago/DBNumberedSlider/blob/master/LICENSE)
* [fishhook](https://github.com/facebook/fishhook) (jailed environment usage only): [BSD-3 License](https://github.com/facebook/fishhook/blob/main/LICENSE).
* [Java Native Access](https://github.com/java-native-access/jna): [Apache 2.0 License](https://github.com/java-native-access/jna/blob/master/LICENSE).
* [shaderc](https://github.com/google/shaderc) (used by mods that uses Vulkan for rendering): [Apache 2.0 License](https://github.com/google/shaderc/blob/main/LICENSE).
* [TOInsetGroupedTableView](https://github.com/TimOliver/TOInsetGroupedTableView): [MIT License](https://github.com/TimOliver/TOInsetGroupedTableView/blob/master/LICENSE).

## Special thanks to these guys
* Thanks to [MCHeads](https://mc-heads.net) for providing Minecraft avatars.
* 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)
1 change: 1 addition & 0 deletions EULA.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# placeholder
30 changes: 15 additions & 15 deletions FFMPEG.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
# Exporting videos with Replay Mod
1. Download the ffmpeg binary [here](https://github.com/Khang-NT/ffmpeg-binary-android/releases/tag/2018-07-31). Choose one according to your device’s architecture.
- (For GitHub builds) Due to the limit of Replay’s command window, you need to rename the executable to a short name, like -> `:fr:`. Let’s call it `<exec_name>`.
2. Install an APK Editor from Google Play or everywhere else.
3. Follow the instructions of the app to add the executable to `/lib/<device_architecture>` folder of the APK. Then build the APK and install it.
- (Required for a clean install) Install everything needed (Forge, Replay Mod).
4. Now launch Minecraft. We haven’t done yet, so force close it after launching.
5. Find latestlog.txt.
- Open it and find this line: `Added custom env: POJAV_NATIVEDIR=<directory>`.
- Copy the `<directory>` part.
6. Launch the game again, go to Replay Viewer and load the record you want to export.
7. Follow Replay’s instructions to add keyframes, then (press T show mouse cursor and) click at `Render Camera Path`.
8. Scroll to the bottom, paste the text you copied in step 5 into the first command line window, then write `/<exec_name>` (step 1) at the end of the text line.
9. Tap `Render` and enjoy your video.
# Exporting videos with Replay Mod

1. Download the ffmpeg binary [here](https://github.com/Khang-NT/ffmpeg-binary-android/releases/tag/2018-07-31). Choose one according to your device’s architecture.
- (For GitHub builds) Due to the limit of Replay’s command window, you need to rename the executable to a short name, like -> `:fr:`. Let’s call it `<exec_name>`.
2. Install an APK Editor from Google Play or everywhere else.
3. Follow the instructions of the app to add the executable to `/lib/<device_architecture>` folder of the APK. Then build the APK and install it.
- (Required for a clean install) Install everything needed (Forge, Replay Mod).
4. Now launch Minecraft. We haven’t done yet, so force close it after launching.
5. Find latestlog.txt.
- Open it and find this line: `Added custom env: POJAV_NATIVEDIR=<directory>`.
- Copy the `<directory>` part.
6. Launch the game again, go to Replay Viewer and load the record you want to export.
7. Follow Replay’s instructions to add keyframes, then (press T show mouse cursor and) click at `Render Camera Path`.
8. Scroll to the bottom, paste the text you copied in step 5 into the first command line window, then write `/<exec_name>` (step 1) at the end of the text line.
9. Tap `Render` and enjoy your video.
64 changes: 39 additions & 25 deletions MODS-UNSUPPORTED.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,16 +6,10 @@ Not everything that works on PC works on PojavLauncher. Below is a non-exhaustiv
- [Rubidium](https://www.curseforge.com/minecraft/mc-mods/rubidium/files) **([patch](https://www.mediafire.com/folder/jcyrf8l0osn4m/Rubidium_1.17%2B) for GL4ES)**
- [Chlorine](https://www.curseforge.com/minecraft/mc-mods/chlorine)
- [ShadersMod (GLSL Shaders)](https://www.minecraftforum.net/forums/mapping-and-modding-java-edition/minecraft-mods/1286604-shaders-mod-updated-by-karyonix)
- [Iris](https://www.curseforge.com/minecraft/mc-mods/irisshaders), [Iris Installer](https://irisshaders.net/download)
- [OptiFine](https://optifine.net/home) (**Render Regions don't work**, everything else does) - Big note here. The only supported shaders are [Open4ES](https://www.mediafire.com/folder/cp87zpb3ichj7/Open4ES) for GL4ES. It works best with Adreno graphics (found in Qualcomm Snapdragon SoCs) and PowerVR graphics, with required patches (found in several low-end MediaTek SoCs). Mali GPUs are not supported. Below is a list of smartphones that are tested and works with Open4ES:

- **Xiaomi Poco F3** (Snapdragon 870)
- **Xiaomi Poco X5 Pro** (Snapdragon 778G)
- **Xiaomi Redmi Note 8** (Snapdragon 665)
- **Oppo A53** (Snapdragon 460)
- [OptiFine](https://optifine.net/home)[^1]

## Skyblock Mods
- [Essential](https://essential.gg/)
- [Essential](https://essential.gg/)[^2]
- [Skytils](https://github.com/Skytils/SkytilsMod) **([1.3.0-pre5](https://github.com/Skytils/SkytilsMod/releases/download/v1.3.0-pre5/Skytils-1.3.0-pre5.jar) works)**
- [Patcher](https://github.com/Sk1erLLC/Patcher) **([1.6.1](https://www.mediafire.com/file/7a3gubce278k338/Patcher-1.6.1_1.8.9.jar/file) works)**
- [NotEnoughUpdates](https://github.com/Moulberry/NotEnoughUpdates/releases) **([2.1.1-pre-1](https://www.mediafire.com/file/u0l09df4riulu2w/NotEnoughUpdates-2.1.1-pre-1.jar/file) works)**
Expand All @@ -28,46 +22,66 @@ Not everything that works on PC works on PojavLauncher. Below is a non-exhaustiv
- almost all of them don't work because they aren't made with Android's inputs in mind

## Other Mods
- [Create](https://www.curseforge.com/minecraft/mc-mods/create)
- [Flywheel](https://www.curseforge.com/minecraft/mc-mods/flywheel)
- [Physics Mod](https://www.curseforge.com/minecraft/mc-mods/physics-mod)
- [Scannable](https://www.curseforge.com/minecraft/mc-mods/scannable) **(Works on 1.12)**
- [Create](https://www.curseforge.com/minecraft/mc-mods/create)[^3]
- [Flywheel](https://www.curseforge.com/minecraft/mc-mods/flywheel)[^3]
- [Physics Mod](https://www.curseforge.com/minecraft/mc-mods/physics-mod)[^4]
- [Scannable](https://www.curseforge.com/minecraft/mc-mods/scannable)[^5]
- [Colormatic](https://www.curseforge.com/minecraft/mc-mods/colormatic)
- ItemPhysic (**[Lite](https://www.curseforge.com/minecraft/mc-mods/itemphysic-lite) works**)
- RandomPatches [**(Forge)**](https://www.curseforge.com/minecraft/mc-mods/randompatches-forge) [**(Fabric)**](https://www.curseforge.com/minecraft/mc-mods/randompatches-fabric)
- [Smooth Font](https://www.curseforge.com/minecraft/mc-mods/smooth-font)
- [MrCrayfish's Gun Mod **(1.16.5)**](https://www.curseforge.com/minecraft/mc-mods/mrcrayfishs-gun-mod)
- [Applied Energistics](https://mcarchive.net/mods/applied-energistics?gvsn=), [Applied Energistics 2](https://www.curseforge.com/minecraft/mc-mods/applied-energistics-2)
- [Zombe](https://forum.feed-the-beast.com/threads/zombe-mod-for-ftb-1-4-7.18012/)
- [ReplayMod](https://www.replaymod.com/) **(FFMPEG wrongly placed)**
- [Dynamic Surroundings](https://www.curseforge.com/minecraft/mc-mods/dynamic-surroundings) **(White textures on 1.12)**
- Sex mod **(thanks *@Adiixyz*)**
- [Immersive Vehicles](https://www.curseforge.com/minecraft/mc-mods/minecraft-transport-simulator) **(Forge Only)**
- [Immersive Engineering](https://www.curseforge.com/minecraft/mc-mods/immersive-engineering) **(Works on 1.12)**
- [Dynamic Surroundings](https://www.curseforge.com/minecraft/mc-mods/dynamic-surroundings)[^6]
- Sex mod[^7]
- [Immersive Vehicles](https://www.curseforge.com/minecraft/mc-mods/minecraft-transport-simulator)[^8]
- [Immersive Engineering](https://www.curseforge.com/minecraft/mc-mods/immersive-engineering)[^5]
- [Immersive Portals](https://www.curseforge.com/minecraft/mc-mods/immersive-portals-mod)
- [Immersive Railroading](https://www.curseforge.com/minecraft/mc-mods/immersive-railroading)
- [Immersive Engineering](https://www.curseforge.com/minecraft/mc-mods/immersive-engineering)
- [DiscordRPC](https://www.curseforge.com/minecraft/mc-mods/discordrpc) - **Big note here. If your PvP/Hack Client crashes because of this, contact their developers for a fix.**
- [DiscordRPC](https://www.curseforge.com/minecraft/mc-mods/discordrpc)[^9]

## Unsupported Clients

- [BatMod](https://batmod.com/)
- [LabyMod](https://www.labymod.net/en)
- [MysteryMod](https://mysterymod.net/)
- [Lunar Client](https://www.lunarclient.com/) **(Obvious reason, ".exe")**
- [Badlion Client](https://client.badlion.net/) **(same as Lunar ^)**
- [Salwyrr Client](https://www.salwyrr.com/) **(how do you expect a launcher to run in a launcher?)**
- [Lunar Client](https://www.lunarclient.com/)[^10]
- [Badlion Client](https://client.badlion.net/)[^10]
- [Salwyrr Client](https://www.salwyrr.com/)[^10]
- [Meteor Client](https://meteorclient.com/)
- [Pizza Client](https://qolhub.kieruken.dev/)
- [Cheeto Client](https://qolhub.kieruken.dev/)
- [3arthh4ck](https://github.com/3arthqu4ke/3arthh4ck) ([patched](https://www.mediafire.com/file/n7ey56j5aued7r0/3arthh4ck-1.8.7-release.jar/file) version here)
- [Ares Client](https://www.aresclient.com/)
# Credits

- https://github.com/Mathias-Boulay/ and all the people in issue [#1948](https://github.com/PojavLauncherTeam/PojavLauncher/issues/1948)
- [Mathias Boulay](https://github.com/Mathias-Boulay/) and all the people in issue [#1948](https://github.com/PojavLauncherTeam/PojavLauncher/issues/1948)

- [ZenZenXDz](https://github.com/ZenZenXDz)

- [revoscode](https://github.com/revoscode)

- https://github.com/ZenZenXDz
- [GaucovyAero](https://github.com/GaucovyAero)

- https://github.com/revoscode
- [Renegade4339](https://github.com/Renegade4339)

[^1]:(**Render Regions don't work**, everything else does) - Big note here. The only supported shaders are [Open4ES](https://www.mediafire.com/folder/cp87zpb3ichj7/Open4ES) for GL4ES. It works best with Adreno graphics (found in Qualcomm Snapdragon SoCs) and PowerVR graphics, with required patches (found in several low-end MediaTek SoCs). Mali GPUs are not supported. Below is a list of smartphones that are tested and works with Open4ES:

- **Xiaomi Poco F3** (Snapdragon 870)
- **Xiaomi Poco X5 Pro** (Snapdragon 778G)
- **Xiaomi Redmi Note 8** (Snapdragon 665)
- **Oppo A53** (Snapdragon 460)
[^2]: Only on certain devices as of this writing. Should it not work in your device, please inform it in our issue tracker or in our Discord server.
[^3]: Disable the Flywheel backend by either one of the two steps (Although despite this, it's completely incompatible with GL4ES on devices with Mali GPUs.):

- https://github.com/GaucovyAero
- Go to `.../config/flywheel.json` and set the `backend` option to `OFF`.
- Have a render set to anything but GL4ES, launch the game, go to any world and execute this command: `/flywheel backend off`
[^4]: Works on IOS and not Android.
[^5]: Works in 1.12.2
[^6]: White textures on 1.12
[^7]: **Thanks *@Adiixyz*** and no, we will NOT provide the link. Go figure.
[^8]: Forge Only
[^9]: Big note here. If your PvP/Hack Client crashes because of this, contact their developers for a fix.
[^10]: Obvious reason: ".exe".
Loading