Go to file
MeirGavish d1bbba82df
Merge pull request #112 from GreenNinja2525/main
Revise Build Instructions
2025-08-30 20:56:32 +03:00
.github/workflows Changed the build CI workflow to be triggered for pushes only to the main branch 2025-07-26 12:54:37 +03:00
audio card_select and card_deselect were flipped, fixed them back. This only affects the sound displayed when cards are scored, now it's the select instead of the deselect. 2025-08-01 21:06:07 +03:00
graphics made all palettes have their length set in grit 2025-08-28 19:03:48 -04:00
include Merge branch 'main' of https://github.com/cellos51/balatro-gba into hblank_affine_background_effects and changed parameters on affine source to be updated from experimental branch 2025-08-28 22:39:48 -04:00
source Small refactor for the joker lists to have wrapping functions to add and remove jokers 2025-08-30 02:15:00 +03:00
.gitignore Added more undesired IDE artifacts to .gitignore 2025-08-12 17:22:42 +03:00
example.gif Add New Gameplay Gif 2025-08-25 07:32:44 -04:00
Makefile Added -g compile flag to allow debug symbols for IDE debugging 2025-08-04 10:20:49 +03:00
README.md Add Missing Instruction and Move Link 2025-08-29 20:12:59 -04:00

Balatro-GBA

Build Status Open Issues Pull Requests

This is an attempt to recreate the game 'Balatro' as accurately as possible, including all of the visual effects that make Balatro feel satisfying to play. This tech-demo/proof of concept is strictly limited in content to a minimal version of Balatro and will NOT recreate the full game. This version is intended for people who already own and know how the official full game works. Please refer to the Balatro Wiki if you need help understanding certain mechanics or abilities.

Balatro Wiki

Disclaimer: This project is NOT endorsed by or affiliated with Playstack or LocalThunk

This is a non-profit community fan project solely aimed to recreate a minimal version of Balatro on the Game Boy Advance as a tribute to the full Balatro and is not intended to infringe or draw sales away from the full game's release or any of the established works by Playstack and LocalThunk.

All rights are reserved to their respective holders.

Please buy the official full version from these sources below:

Balatro on Steam Balatro on Google Play Balatro on Apple App Store Balatro on Nintendo eShop Balatro on PlayStation Store Balatro on Xbox Balatro on Humble Bundle

Example GIF

Controls:

(A: Pick Card/Make Selections)

(B: Deselect All Cards)

(L: Sell Joker)

(R: Sort Suit/Rank)

(D-Pad: Navigation)

Build Instructions:

-Windows-

Video Tutorial: https://youtu.be/72Zzo1VDYzQ?si=UDmEdbST1Cx1zZV2

With Git (not required)

1.) Install devkitPro from https://github.com/devkitPro/installer by downloading the latest release, unzipping the archive, and then running the installer. You only need to install the tools for the GBA development so ensure you have it selected and install it to the default directory. You may need to create a temp folder for the project.

2.) Search for MSys2 in the Start Menu and open it.

3.) Install Git by typing this command: pacman -S git if you don't have it already installed

4.) Clone the project by putting git clone https://github.com/cellos51/balatro-gba.git in the MSys2 window.

5.) Use cd and drag the new folder into the window to add the file path and press Enter.

6.) Type make into the window and press Enter to start building the rom.

7.) After it completes, navigate through the build directory in the project folder and look for balatro-gba.gba and load it on an emulator or flashcart.

Without Git

Disregard Steps 3-4 and instead click the green code button on the main repository page and press Download Zip. Unzip the folder and place it wherever you like. Then continue from Step 5.

Common Issues:

1. When I run make it errors out and won't compile!

  • Move the project folder to your desktop and then cd to it by dragging the folder into the terminal window. This error could be caused by a bad file path, placing the folder on the desktop is a failsafe.

2. I can't find the compiled rom!

  • Look for a folder called build inside the project folder and then find balatro-gba.gba.

3. The Game won't start!

  • Try a different emulator or if you are using original hardware, make sure the rom is not corrupted and try a different flashcart or SD Card. If this does not work, open an issue on the Github page because a recent commit may have broke the game.

4. It says I don't have Git or Make installed!

  • Use pacman -S git (not required) or pacman -S make although make should already be installed if you followed the instructions correctly.