Balatro API

bal is in scope in balatro_exec. Balatro is turn-based and waits for you: nothing happens between your actions. Every action returns the game state after the game settled.

State

await bal.state() (alias bal.observe()) returns the game state as balatrobot reports it:

• state: where the game is. BLIND_SELECT (choose to play or skip the next blind), SELECTING_HAND (play or discard cards), ROUND_EVAL (the round is won; cash out), SHOP, SMODS_BOOSTER_OPENED (a booster pack is open; pick from it or skip), GAME_OVER.
• ante_num, round_num, money, deck, stake, seed, won (true once the boss blind of ante 8 is beaten).
• round: hands_left, hands_played, discards_left, discards_used, reroll_cost, chips (scored this round).
• blinds: small, big, boss, each with type, status (SELECT, CURRENT, UPCOMING, DEFEATED, SKIPPED), name, effect, score (chips needed), tag_name, tag_effect (the tag for skipping it).
• hands: per poker hand its level, chips, mult, played, played_this_round.
• Card areas, each { count, limit, highlighted_limit, cards }: hand, jokers, consumables, cards (the deck), and in the shop shop, vouchers, packs; pack when a booster pack is open. Areas that are empty and not always present are left out.
• A card: id, key (for example H_A for the Ace of Hearts, j_joker, c_fool), set, label, value (suit, rank, effect: what it does, in the game's words), modifier (seal, edition, enhancement, eternal, perishable, rental), state (debuff, hidden, highlight), cost (buy, sell).
• used_vouchers.

Suits are H, D, C, S; ranks 2-9, T, J, Q, K, A.

Actions

Indices are 0-based positions in the area as the state lists it.

• await bal.select(): play the blind that is up (BLIND_SELECT).
• await bal.skip(): skip the small or big blind for its tag (BLIND_SELECT). The boss blind cannot be skipped.
• await bal.play([i, ...]): play 1 to 5 cards from hand (SELECTING_HAND).
• await bal.discard([i, ...]): discard cards from hand (SELECTING_HAND).
• await bal.cashOut(): collect the round's reward and go to the shop (ROUND_EVAL).
• await bal.buy({ card: i }), bal.buy({ voucher: i }), bal.buy({ pack: i }): buy from shop, vouchers or packs (SHOP). A bought pack opens at once.
• await bal.pack({ card: i }): take card i from the open pack; bal.pack({ card: i, targets: [j, ...] }) when that card needs cards from hand as targets; bal.pack({ skip: true }) to take nothing (SMODS_BOOSTER_OPENED). Tarot, Planet and Spectral cards from a pack are used at once; Jokers go to jokers, playing cards to the deck.
• await bal.sell({ joker: i }), bal.sell({ consumable: i }).
• await bal.use(i, [j, ...]?): use consumable i, with cards from hand as targets when it needs them.
• await bal.rearrange({ hand: [...] }), bal.rearrange({ jokers: [...] }), bal.rearrange({ consumables: [...] }): the new order, as a permutation of the current indices. Joker order matters for some Jokers.
• await bal.reroll(): reroll the shop for round.reroll_cost (SHOP).
• await bal.nextRound(): leave the shop (SHOP).
• await bal.screenshot(): the game window as an image (the state is the ground truth; the picture is for orientation).
• await bal.restart(): only after a game over (state GAME_OVER): a new run with the same deck and stake. Every other action is refused until you restart.

An action that does not fit the game's state or rules is refused with an error that says why; read the state first. The run has already been started for you (deck, stake and seed are fixed); starting runs, returning to the menu, saving, loading and changing the game's values are not available.