v0.6.0

0.6.0 (2025-10-22)

Features

• add --status option to show running balatro instances (bcfeb91)
• add ante value to game state (f7193c4)
• add audio flag to balatrobot (disabled by default) (9c2db00)
• add balatro enums (fc8d6b4)
• add balatro.sh script for running multiple instances (d66fe98)
• add balatrobot logo (b95d1d1)
• add blind_on_deck to game_state and ftm code (79da57f)
• add card limit to joker game data (8cb99cf)
• add cards argument to use_consumable (1775952)
• add check and test case for whether a buy_and_use_card target can be used (dab8f19)
• add decks and stakes enumns (d89942b)
• add extensive logging to python code (56c7c80)
• add hook for buy_card, should work with buy_and_use card (a6b8b0f)
• add hook for joker rearrangement (c9fe966)
• add hook for sell_consumable (e390761)
• add hook for use_consumable (d54042c)
• add rearrange consumeables endpoint (404de7d)
• add rearrange jokers endpoint (b63c500)
• add RearrangeConsumeablesArgs type (e7796cc)
• add redeem_voucher (70e8cb0)
• add render on api env var / flag (b96e623)
• add reroll cost < dollars check (644f667)
• add reroll shop action (1202866)
• add sell consumable completion condition (dcff055)
• add sell consumable endpoint (c467611)
• add sell joker completion condition (e4b3b6e)
• add sell joker endpoint (183db62)
• add sell joker types (876a249)
• add sell_joker hook for logging (44df912)
• add settings.lua for configuring Balatro (4b36304)
• add shop_idle() cond for actions that do not depart the shop (987e965)
• add sort_id to card in game state (77bc507)
• add state checking for use consumable with cards parameter (ec123d6)
• add test-migrate target to Makefile (5c41d17)
• add types for joker card limit and count (207c41b)
• add types for sell consumable (b395430)
• add use consumable endpoint (012a957)
• add use_consumable completion condition (44cdcf7)
• added tests and gamestate for reroll shop (4bc1b61)
• api: add cashout API function (e9d86b0)
• api: add comprehensive error handling and validation system (c00eca4)
• api: add comprehensive function call logging system (38a3ff9)
• api: add hands_left to current_round game state (79cec38)
• api: add log_path optional param to start_run (e9b986c)
• api: add screenshot API endpoint (165b58c)
• api: add shop action support with next_round functionality (6bcab8a)
• api: add shop booster field to game state (48c4fd6)
• api: add shop jokers field to game state (ad062bb)
• api: add shop vouchers field to game state (b998062)
• api: game over and no discard left edge cases (5ad134a)
• api: handle winning a round in play_hand_or_discard (975b0b7)
• api: implement play_hand_or_discard action (2c0ae92)
• api: improve cards selection ranges in use consumeables (b9ce462)
• api: improve logging for function calls (8ba681e)
• api: integrate logging system into main mod (3c4a09f)
• api: new improved game state object (4e2f5ac)
• api: new types for the G game state object (7a23f6f)
• api: validate state in the usage of API functions (94a58b5)
• better api errors (617cbc9)
• bot: add standardized error codes enum (2c9fdaa)
• bot: add TCP-based replay bot for JSONL files (b5b6cf8)
• bot: replace Bot ABC with structured API client (3a70fde)
• bots: improve replay script with proper CLI (e38cbd4)
• checkpoints work (1e78386)
• client: add port option to client (4c7b912)
• client: add screenshot method (0ee8b8c)
• created savefile-based checkpointing (73ab99f)
• dev: add commit command with conventional commits spec (95e4067)
• dev: add Makefile (02c569f)
• dev: add test command and improve process detection (344d1d3)
• docs and types for checkpointing (5efff03)
• enhance rearrange jokers field in game state (e72c78e)
• examples: update example bot to use new client API (73bf5b7)
• finish buy_and_use_card docs (c644bab)
• hook reroll_shop (0e533ae)
• implement game speed up (b46995f)
• improve CLI for replay bot (077178c)
• improved graphics settings for screenshots (86af829)
• init lua code socket server (85b5249)
• log: add hand rearrange logging (WIP) (7ea6b37)
• log: add JSONLLogEntry model and flexible arguments field (3e8307a)
• log: add log module functions to Log type (732039c)
• log: add logging to BalatroClient connection and API calls (3776c9c)
• log: add types for log module (719e3ff)
• log: hook for rearrange_consumeables (06f5be7)
• log: improved logging system (#39) (919f59d)
• log: ts before and after for each log entry and refactoring (40fd9ba)
• make host configurable via env var (0fc9b9b)
• markdown format (f361c9c)
• move checkpoint binaries to git lfs (5b3c513)
• port balatrobot to new smods format (bb24993)
• prototyping checkpoint system (7bdf5e2)
• redeem voucher docs (8e894e0)
• remove botlogger and simplify lua code (e3dcbd5)
• remove start/stop balatro methods (76a431a)
• reroll shop types (40a9e33)
• reroll_shop docs (845799c)
• revert bloom string (b366f15)
• shop condition based on timing (b713204)
• skip initial splash screen when starting Balatro (58922f2)
• stylua (8bbc51a)
• tests for checkpointign (9c04ff6)
• tests for redeem_voucher (5982d82)
• tests: add TCP client support to test infrastructure (ff935f3)
• track test checkpoints with git lfs (0ecbb43)
• update Bot with types and new abc methods (da47254)
• update example bot to the new Bot class (a996b06)
• update game state with consumeables (2fb2cbc)
• update mod entry point to new lua code (5158a56)
• update models to match lua types (0a224ea)
• update MyFirstBot to use Decks and Stakes enums (6c0db6f)
• updated types for redeem_voucher (9fe3e67)
• using checkpoints in test_shop (4c52efc)
• utils: add completion conditions table in utils (a36f9eb)
• utils: add sets_equal function (133b150)
• WIP save file manipulation (8cbae31)

Bug Fixes

• action params format (5478ede)
• add missing set fields in game state (ee92ac0)
• adjust balatro settings (866d201)
• api: add card count validation to play_hand_or_discard function (0072a0e)
• api: add event queue threshold check to skip_or_select_blind (91e4613)
• api: add event queue threshold check to start_run condition (ea210ed)
• api: add event queue threshold to skip_or_select_blind (f9c6f04)
• api: add seed warning for non-reproducible runs (b996f45)
• api: clear hand highlights before selecting new cards (9efb351)
• api: correct blind state key from Large to Big in comment (f7e5c42)
• api: correct socket type references from UDP to TCP (149d314)
• api: prevent skipping Boss blind in skip_or_select_blind (dc66e7e)
• api: remove misleading comment and fix typo in logging system (859a50a)
• buy card hook (#68) (6412506)
• ci: correct YAML indentation in deploy docs workflow (ca2d797)
• client: increase timeout to 30s (6f315e1)
• client: make arguments optional in send_message (56419f5)
• dev: remove --check flag from mdformat command (3f710b8)
• effect for c_eris (fd564ce)
• fast profile for balatro (ac4eaa5), closes #83
• include ActionSchema in init.py exporting (72b06ab)
• key for G.GAME.skips (d99b4c9)
• log: update type definitions to match implementation (4bbe051)
• long messages limit in luasocket (7d6168b)
• lua type for BalatrobotConfig (2ae6055)
• make use of shutil.move instead of os.rename (c908326)
• reduce default mod dt to 4/60 (21ea63b)
• remove set_ranks and align_cards from rearrange_hand (7ae211e)
• remove unused out of place test (163e4a8)
• revert shop() -> cash_out() (a2555a4)
• shop check (c77c52b)
• skip tutorial (190ae71)
• spelling for debuf to debuff (e18ebfe)
• tmp fix for 8k luasocket buffer size (#103) (d6f6cde)
• update debuff name in game state (d2a4769)
• utils: check if GAME is nil in get_game_state (d714c83)
• utils: prevent UI-related keys from being sanitized (d37c2aa)
• validate that index is an integer (e9ccc62)

Documentation

• add api-protocol page to the docs (11a7971)
• add audio option to docs for contributing (045bcf7)
• add badges to readme (fdfdb7d)
• add balatro documentation as git submodule (5275d1c)
• add CLAUDE.md with development guidelines and commands (be7898e)
• add comprehensive BalatroBot Python API reference (548c0c3)
• add comprehensive logging systems documentation (b09d830)
• add contributing.md (b149388)
• add dev env setup to bot-development.md (f8a5b49)
• add docs generated by llm (1f5ef80)
• add homepage to docs (77df9d6)
• add log_path parameter to start_run (4c74244)
• add logo configuration to mkdocs theme (7ba1413)
• add MIT license (6ee693c)
• add pre-1.0 development warnings to README and docs (3d70496)
• add project link to readme (bddbad1)
• add rearrange consumables to protocol api (d1ec66f)
• add sell consumable endpoint to protocol-api.md (209b0d8)
• add sell joker to protocol-api.md (ce99b11)
• add use_consumable to protocol-api.md (20915c7)
• api: add standardized error codes and improve formatting (5ca9813)
• api: add TODO comment for additional shop actions (34071a2)
• api: refactor API protocol documentation for TCP implementation (411268b)
• bot: init version for new balatrobot python package (a29996e)
• clean up formatting and mkdocs configuration (4ec6e21)
• configure mkdocs-llmstxt plugin for LLM-friendly documentation (aaf9b38)
• dev: add configuration system documentation (16933cd)
• dev: clarify commit command formatting guidelines (12130f2)
• dev: improve CLAUDE.md development commands and testing guidance (2883a6d)
• dev: improve code documentation and comments (b06c259)
• dev: refine commit command workflow instructions (c3340e6)
• dev: update commit command co-author handling (b554b44)
• dev: update commit command scope and co-author docs (c089ff5)
• dev: update test suite metrics after shop API addition (8c49a7d)
• dev: update test suite metrics in CLAUDE.md (cc5b159)
• dev: update test suite statistics (dcf44fe)
• enhance mkdocs config (8a1714e)
• expand documentation with new references and best practices (f4f6003)
• fix english grammar (d14d9b2)
• fix mkdocs palette configuration format (0756cd3)
• improve bot-development page (987e7eb)
• improve MkDocs API documentation formatting (7a537c2)
• remove content from troubleshooting (8f454b4)
• remove emoji from docs (b5acd72)
• remove empty troubleshooting page and references (b69d2ed)
• remove legacy content in the README (42cbde3)
• remove legacy pages from mkdocs.yml (2947b32)
• remove legacy pages from the docs (53cb13b)
• remove pre-1.0 notice (4c232d0)
• remove redundant commands and refine existing ones (a1e4d07)
• remove table of contents from md files (249ec7e)
• renamed log file and provide suggestion for Timeout errors (ce6aa6d)
• replace troubleshooting with LLM documentation links on homepage (b632077)
• restructure documentation and configure mkdocstrings (e89e34a)
• simplify docs and add mermaid diagrams (5fca88c)
• simplify the contributing guide (b3a729b)
• tmp fix for line numbers in code blocks (939146a)
• update API documentation page titles (ab79ef3)
• update badges in readme (1353177)
• update balatrobot api with new models (d611270)
• update CLAUDE.md with new make commands (0f6c1e6)
• update CLAUDE.md with test prerequisites and workflow (f7436e0)
• update contributing.md with new instructions for running tests in parallel (44306dd)
• update docs themes (6059519)
• update docs/protocol-api.md with new sign for rearrange_hand (6eff295)
• update installation guide (6afc3cd)
• update links the from S1M0N38 to coder (7b77fae)
• update README (325dd20)
• update README.md with docs and contributors (ba2c9da)
• update the path of the example bot (023dbb0)
• updpate bot-development docs page (c687417)
• use mkdocs admonition for warning (11a0b0e)