This repository, "Balatro-GBA," is a fan-made demake of the popular deck-building roguelike game "Balatro" for the Game Boy Advance (GBA). Its primary purpose is to recreate the core gameplay and visual style of "Balatro" on the limited hardware of the GBA, offering a portable and nostalgic experience for fans of the original game. The project is a non-profit endeavor, explicitly stating that it is not affiliated with or endorsed by the original developers, Playstack and LocalThunk, and is not intended for commercial sale. The project aims to provide a minimal tech-demo, focusing on core gameplay mechanics and visual fidelity, rather than a fully comprehensive port.

The main feature of the repository is the playable GBA version of "Balatro." This includes the core gameplay loop of the original, where players build a poker-based deck, strategically playing hands to score points and earn money to buy powerful joker cards and other enhancements. The project aims to replicate the satisfying visuals of the original game, adapting them to the GBA's limitations. The repository provides build instructions for various operating systems, including Windows, Linux, and macOS, as well as a Docker-based build environment, making it accessible for users with varying levels of technical expertise. The build process involves using the devkitPro toolchain, a collection of tools specifically designed for GBA development.

The repository's README file provides a clear disclaimer, emphasizing the project's non-commercial nature and its reliance on the original game's assets and mechanics. It directs users to the official "Balatro" sources for purchase and provides links to the game on various platforms. The README also includes a link to the Balatro wiki, which is essential for understanding the game's complex mechanics and joker effects, as the GBA version is intended for those already familiar with the original.

The project also includes a comprehensive set of controls, mapping the game's actions to the GBA's D-pad and buttons. The controls are designed to be intuitive and allow players to navigate menus, select cards, play hands, and manage their joker cards. The README also provides a section for contributing, encouraging community involvement in the project's development.

The repository also provides a "Download ROMs from the Releases tab" link, allowing users to easily obtain pre-built ROM files to play on emulators or GBA flashcarts. The README also addresses common issues that users might encounter during the build process or while playing the game, providing troubleshooting tips and solutions.

The project acknowledges the original creators of "Balatro" and credits the contributors to the GBA implementation. It also credits the sources of the music, imagery, and sound effects used in the game, ensuring proper attribution and respecting the original creators' intellectual property. The music arrangement is credited to @cellos51, based on the original soundtrack by LouisF and transcriptions by MrCrimit. The sprites and backgrounds are based on the original imagery created by LocalThunk. Sound effects are sourced from both LocalThunk and the free sound archive, Freesound.org. This comprehensive approach to credits demonstrates the project's commitment to respecting the original game and its creators.