Repository navigation
Howdy! This release is mostly about updating feel and performance. I've fixed many differences in scoring order and Joker behavior, added the fun lava-lamp background of the original game (on New 3DS hardware only), and begun implementation of a few of my favorite QoL mods. Please let me know if you have any issues!
Read change log
Mods
- Added a native port of nh6574's JokerDisplay mod: every Joker shows its live value under the Joker row on the top screen, reminder line included, with chance Jokers shown as rolls. Off by default; turn it on under Settings > Joker Info.
Gameplay
- Played hands now run the same four phases as the original: a before pass, per-card scoring, the main joker pass, and an after pass. Jokers that used to resolve silently in a single frame now each get their own beat.
- Discards walk card by card, left to right, with a pre-discard pass in front of them. Ramen, Yorick, Castle, Mail-In Rebate and Hit the Road take one card at a time, and a Ramen that runs out partway through stops eating the rest of the discard.
- Round-end Jokers (Popcorn, Turtle Bean, Gros Michel, Cavendish, Invisible Joker) stagger on the playfield before the Cash Out panel slides in.
- Fixed Joker timing: Midas Mask, Matador, Vagabond, Superposition, Seance, Ice Cream, Seltzer and Sixth Sense now run in their correct phases. A gold card Midas made can be drained by Vampire, and a Bonus King no longer pays before Midas fires.
- Fixed Yorick silently eating a beat on every discarded card.
- The ante now steps when the boss falls rather than when you leave the shop.
- Fixed Jokers staying face-down after the Amber Acorn blind resolves.
- Fixed Planet tooltips reprinting the same line four times and overrunning their box.
- Hand level-up animations run on the game speed clock, so 4x speed actually speeds them up.
Presentation
- Cards are destroyed the way the original destroys them: they hold their size and burn away from the margins inward behind a coloured front, instead of shrinking out. Shadows burn with the card.
- Dissolves shed shards for the whole effect, sampled from the full palette and on the original's size envelope. A Joker sold for gold burns gold; a Glass card goes out pale.
- Buying a card no longer burns the shelf copy and materialises a second one — the card you bought flies to its slot.
- Cards with an edition announce themselves one at a time as they appear in the shop, with the sting the original plays.
- Foil and holo tints in the shop are pushed apart so they no longer read as the same pale wash.
- Half Joker, Square Joker and Photograph are centred in their slot, so their outlines and tooltips line up with the art.
- The lava-lamp background now sits behind the whole game rather than just the menu, and snaps cleanly when the palette changes between screens.
- Fixed a slow scanline artifact marching down the background on hardware.
- Used consumables flinch before they come apart.
- Crisp fonts are on by default: every text size is rendered rather than resampled.
Performance
- Rebuilt the renderer's draw path: draw commands are arena-allocated, texture coordinates are cached, and adjacent compatible draws are merged into one submission.
- On a New 3DS, the background field is computed on the spare CPU core.
- The background costs about 1.9 ms a frame across both screens, down from 3.7 ms.
- Settled cards and Jokers stop updating, and card draws resolve their position in one pass instead of walking a parent chain every frame.
- Text caches its layout instead of re-shaping every frame.
- Booster pack art loads a sprite per frame while the pack flies in, so opening one no longer freezes.
- Idle collision checks are constant-time, the save file is stat-ed on write instead of every frame, and garbage collection runs on an even cadence rather than in bursts.
Controls
- Touch and buttons no longer fight: tapping a card clears the D-pad cursor and its tooltip, and the next button press restores focus where you were last looking rather than acting on a target you cannot see.
Hardware
- Added a release build that ships without the developer benchmark tools.
- The app is now titled "Balatro" on the Home Menu.
- Rewrote the README around installing, controls, and hardware caveats.