From d0821ff1775ef9dbba30c4c0e68b005f06757fd9 Mon Sep 17 00:00:00 2001 From: antipatico Date: Sat, 27 Apr 2024 15:26:45 +0200 Subject: [PATCH] v0.3.0 --- README.md | 44 +++++++++++++++++++++--------------- balatromobile/__version__.py | 2 +- misc/video-thumb-1.png | 3 +++ 3 files changed, 30 insertions(+), 19 deletions(-) create mode 100644 misc/video-thumb-1.png diff --git a/README.md b/README.md index b283f95..33e103f 100644 --- a/README.md +++ b/README.md @@ -27,16 +27,22 @@ balatromobile android Balatro.exe This command will output an APK with all needed patches and already signed. Ready to be installed on your Android device. ## Save files -If your device is running Android 12 or prior, you can enable the `external-storage` patch. If you do, you will find your save files in your sdcard, more specifically under: +If your device is running Android 12 or prior, you will find your save files in your sdcard, more specifically under: ``` -Android/data/dev.bootkit.balatro/ +/sdcard/Android/data/dev.bootkit.balatro/ ``` -If your device is running Android 13 or later, you should **NOT** enable the `external-storage` patch. In this case, you can browse the game files using `run-as` in `adb`, for example: +If your device is running Android 13 or later, you cannot access directly your files from your computer. Fortunately, you can use applications which supports the Storage Access Framework API (such as [FX File Explorer](https://play.google.com/store/apps/details?id=nextapp.fx) and [Material Files](https://play.google.com/store/apps/details?id=me.zhanghai.android.files)) to access the files from your device: + +[![Video tut](misc/video-thumb-1.png)](https://vimeo.com/939997099 "Click to Watch!") + + + +If you disable the `external-storage` patch, you can browse the game files using `run-as` in `adb`, for example: ```bash adb shell run-as dev.bootkit.balatro ls ``` -This is finnicky and error prone. I could implement a python implementation to backup and restore game files in case of _"internal-storage"_ +This is finnicky and error prone and not reccomended. ## Patches Every patch is versioned, allowing the upkeeping of different patches for different versions of the game. @@ -46,18 +52,19 @@ A refactor is needed to make the version system make sense. You can list the available patches using the `list-patches` command: ``` $ balatromobile list-patches -Name Description Platforms ----------------- ----------------------------------------------------------------------------------------------- ----------- -basic Basic set of patches needed to make the game run on mobile android -crt Disable CRT effect [Fixes blackscreen bug on Pixels and other devices] android,ios -external-storage Save game files under /sdcard/Android [Works well for Android < 13] android -fps Cap the FPS limit to the FPS limit of the screen android,ios -landscape-hidpi Forces the game to always stay in landscape mode and apply hidpi fix for iOS ios -landscape Forces the game to always stay in landscape mode, ignoring the screeen orentation of the device android,ios -no-background Disable background animations and effects. From PortMaster android,ios -nunito-font Replace the main font used with nunito, optimized for smaller displays. From PortMaster android,ios -simple-fx Disable gameplay visible behind menu background, shadows, and bloom effects. From PortMaster android,ios -square-display Optimize for square and square-like displays. From PortMaster android,ios +Name Platforms Description Authors +---------------- ----------- ----------------------------------------------------------------------------------------------- --------------------------- +basic android Basic set of patches needed to make the game run on mobile blake502,TheCatRiX,PGgamer2 +nunito-font android,ios Replace the main font used with nunito, optimized for smaller displays. From PortMaster nkahoang,rancossack +simple-fx android,ios Disable gameplay visible behind menu background, shadows, and bloom effects. From PortMaster nkahoang,rancossack +landscape-hidpi ios Forces the game to always stay in landscape mode and apply hidpi fix for iOS blake502 +external-storage android Save game files under /sdcard/Android [Works well for Android < 13] blake502 +landscape android,ios Forces the game to always stay in landscape mode, ignoring the screeen orentation of the device blake502 +fps android,ios Cap the FPS limit to the FPS limit of the screen PGgamer2 +no-background android,ios Disable background animations and effects. From PortMaster nkahoang,rancossack +shaders-flames android,ios Fix the flames shaders for mobile PGgamer2 +crt android,ios Disable CRT effect [Fixes blackscreen bug on Pixels and other devices] blake502 +square-display android,ios Optimize for square and square-like displays. From PortMaster nkahoang,rancossack ``` It is possible to specify the list of patches you want to apply by supplying a comma-separated list of patches, for example: ```bash @@ -65,7 +72,8 @@ balatromobile android Balatro.exe --patches basic,landscape,external-storage ``` ## Supported Game Versions -* 1.0.1c +* 1.0.1e-FULL +* 1.0.1c-FULL ## Advanced Usage ``` @@ -80,7 +88,7 @@ options: --output OUTPUT, -o OUTPUT Output path for apk (default: balatro-GAME_VERSION.apk) --patches PATCHES, -p PATCHES - Comma-separated list of patches to apply (default: basic,landscape,crt,fps) + Comma-separated list of patches to apply (default: basic,landscape,crt,fps,external-storage,shaders-flames) --skip-sign, -s Skip signing the apk file with Uber Apk Signer (default: False) --display-name DISPLAY_NAME Change application display name (default: Balatro Mobile (unofficial)) diff --git a/balatromobile/__version__.py b/balatromobile/__version__.py index 430375e..4e3f3d3 100644 --- a/balatromobile/__version__.py +++ b/balatromobile/__version__.py @@ -1 +1 @@ -__version__="0.2.1" \ No newline at end of file +__version__="0.3.0" \ No newline at end of file diff --git a/misc/video-thumb-1.png b/misc/video-thumb-1.png new file mode 100644 index 0000000..e39ec24 --- /dev/null +++ b/misc/video-thumb-1.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:c7b409598a16995aa870c7e93586e116c4da15b6048749b0710ab1596246c22e +size 37090