Skip to content

A shell script to patch the Android version of Minecraft to allow building on the nether roof and the use of shaders for RenderDragon

License

Notifications You must be signed in to change notification settings

Coffee-0xFF/MCBE_Android_Patcher

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 

Repository files navigation

MCBE_Android_Patcher

A shell script to patch the android arm32 and arm64 versions of minecraft bedrock edition

Tested on Minecraft Bedrock Edition 1.21.23 may not work in future versions

You need the official android version to use this script

Patches:

  1. allow construction on the nether roof;
  2. allow installation of shaders for renderdragon;

Screenshots: nether_roof

shaders

How to use

On Linux

  1. Make a backup of your worlds

  2. Install the following dependencies

  • java-openjdk (openjdk)
  • zsh
  • patchelf
  • wget
  • sed
  • android-tools (android-tools-adb)
  1. Enable USB debugging on your phone in developer options

  2. Connect your phone to your computer via USB cable

  3. download the script and give it execution permissions with the following commands

wget -O ~/MCBE_Patcher.sh https://raw.githubusercontent.com/Coffee-0xFF/MCBE_Android_Patcher/main/Minecraft_Patcher.sh
chmod +x ~/MCBE_Patcher.sh
  1. Run the script with the option adb. If all processes are successful, the script will automatically modify the game, uninstall the original and install the new modded apk
~/MCBE_Patcher.sh adb



On Android

  1. Make a backup of your worlds

  2. Using a file manager, copy the APKs from the split APK downloaded from the Google Play Store to a folder, compress the files into a zip (some file managers, like X-Plore for example, do compression automatically), and rename the zip file to Minecraft.zip

  1. Install the Termux app

  2. Open termux and run the following commands one at a time to install the dependencies

termux-setup-storage
apt update
apt upgrade
apt install -y apksigner openjdk-17 sed zsh wget patchelf
  1. Now locate the folder with the zip file with the apks and go to it with the cd command

example:

cd ~/storage/shared/my_folder_with_the_zip_file/

you can use the ls command to list the folders and files in the path you are

ls
  1. download the script and give it execution permissions with the following commands
wget -O ~/MCBE_Patcher.sh https://raw.githubusercontent.com/Coffee-0xFF/MCBE_Android_Patcher/main/Minecraft_Patcher.sh
chmod +x ~/MCBE_Patcher.sh
  1. Run the script, if it is already in the folder with the zip file with the apks.
~/MCBE_Patcher.sh ./Minecraft.zip
  1. If everything went well, you now have a modified apk with the path ~/minecraft_modded.apk, so move it to your phone's internal memory with the following command
mv ~/tmp/output/minecraft_modded.apk ~/storage/shared/minecraft_modded.apk
  1. Now uninstall the original game and install the minecraft modded manually

General notes:

You can disable one of the two patches, to do this, change the value 1 of the variables nether_roof_limit_to_256 or materialbinloader to 0. The materialbinloader patch allows the installation of shaders.

This script only works with Android versions downloaded from the Google Play Store

This script only works for the game compiled for arm or aarch64 (arm64)

DO NOT share the apk generated by you, this violates the EULA


Links


Special Thanks

- , thanks for reverse engineering the game

About

A shell script to patch the Android version of Minecraft to allow building on the nether roof and the use of shaders for RenderDragon

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages