Skip to content

Commit

Permalink
v0.3.0
Browse files Browse the repository at this point in the history
  • Loading branch information
antipatico committed Apr 27, 2024
1 parent 01871b2 commit d0821ff
Show file tree
Hide file tree
Showing 3 changed files with 30 additions and 19 deletions.
44 changes: 26 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -46,26 +52,28 @@ 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
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
```
Expand All @@ -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))
Expand Down
2 changes: 1 addition & 1 deletion balatromobile/__version__.py
Original file line number Diff line number Diff line change
@@ -1 +1 @@
__version__="0.2.1"
__version__="0.3.0"
3 changes: 3 additions & 0 deletions misc/video-thumb-1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit d0821ff

Please sign in to comment.