v1.3.4

1.3.4 (2026-01-13)

Bug Fixes

• balatrobot: add session_id to BalatroInstance (79230dd)

v1.3.3

1.3.3 (2026-01-12)

Continuous Integration

• release: move release notification to pypi workflow (2274781)

v1.3.2

1.3.2 (2026-01-12)

Bug Fixes

• lua.endpoint: add nil checks for race condition in next_round endpoint (ce08dcc)
• lua.endpoints: fix error message for invalid voucher/pack index in buy (4af3d39)

v1.3.1

1.3.1 (2026-01-11)

Bug Fixes

• lua.endpoints: fix pack with mega packs with double target selection (ba3e270)

v1.3.0

1.3.0 (2026-01-06)

Features

• lua: improve logging for endpoints (680fd45)

Documentation

• cli: remove resize rule in hyperland config example (ace84b5)
• update deps and style of the docs (784b780)

v1.2.2

1.2.2 (2026-01-04)

Documentation

• contributing: add linux native symlink location (d07c354)
• example-bot: add example bot page (73c4313)
• prepend uvx to balatrobot command (e9e48e1)

v1.2.1

1.2.1 (2026-01-01)

Bug Fixes

• ci: update release workflow to sync openrpc.json version (905609f)

Documentation

• contributing: update .luarc.json example (c9c486a)
• use white logo version for docs logo (e532087)

v1.2.0

1.2.0 (2026-01-01)

Features

• lua.endpoints: add pack endpoint (32ff3eb)
• lua.endpoints: add pack endpoint (9d3031f)
• lua.endpoints: add support for adding packs to the add endpoint (41374a7)
• lua.endpoints: allow rearranging cards during booster pack state (16e4170)
• lua.endpoints: extend rearrange to pack state (15f282c)
• lua.utils: add cards field to gamestate (8447855)
• lua.utils: add pack keys enums (d8cdb33)

Bug Fixes

• lua.endpoints: await hand to be loaded for Arcana/Spectral packs (43e41a4)
• lua.endpoints: improve await condition when buying a pack (4993e77)
• lua.utils: use appropriate field for the request in debugger (d79a81d)
• lua: fix target selection to wait longer (e98d4ea)
• validator: revert to old behaviour for array items (729e164)

Performance Improvements

• change pytest-xdist config from loadfile to loadscope (d7c2a28)

Documentation

• add conventional commits guideline to contributing (bf164b1)
• api: add required state for rearrange endpoint (481d579)
• api: fix api.md formatting (4c85dec)
• api: remove comment from the gamestate example (44a169f)
• api: update the add endpoint to support packs (36868f2)
• CLAUDE: add GitHub repo link to CLAUDE.md (9013de0)
• docs fixes (099147a)
• endpoints: fix pack_select formatting (535e3b0)
• endpoints: fix pack_select formatting (7c0535c)

v1.1.0

1.1.0 (2025-12-24)

Features

• balatrobot: add Windows support to CLI (843a1b7)

Documentation

• cli: run_lovely_macos.sh is not required (ccf1996)
• contributing: improve contributing guide (d5576b2)
• index: remove link to legacy docs (23029cd)
• readme: remove the imgs from the related project section (354de3a)

v1.0.0

1.0.0 (2025-12-23)

⚠ BREAKING CHANGES

• update to v1.0.0

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 back the test target in Makefile (ebfbfb5)
• add balatro enums (fc8d6b4)
• add balatro.py python script (c0ae64f)
• add balatro.sh script for running multiple instances (d66fe98)
• 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 cli entry point for balatrobot (394e8c8)
• add gamestate menu and start endpoints to balatrobot loading (6aebc4a)
• add hook for joker rearrangement (c9fe966)
• add hook for sell_consumable (e390761)
• add hook for use_consumable (d54042c)
• add new description field to card objects (0a55df6)
• add new skip endpoint to balatrobot.lua (b02b675)
• add option to disable shaders with env var BALATROBOT_NO_SHADERS (6be3497)
• 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 select endpoint to balatrobot.lua (0414d33)
• 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 shop_idle() cond for actions that do not depart the shop (987e965)
• add state checking for use consumable with cards parameter (ec123d6)
• add test-migrate target to Makefile (5c41d17)
• 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 screenshot API endpoint (165b58c)
• api: improve cards selection ranges in use consumeables (b9ce462)
• balatrobot: add CLI interface and entry points (429ee26)
• balatrobot: add configuration and path utilities (8fa562a)
• balatrobot: add HTTP health check utility (b8fe42c)
• balatrobot: add macOS and native platform launchers (49ed21d)
• balatrobot: add multi-instance manager (57d1dac)
• balatrobot: add platform abstraction layer (d57b4cd)
• balatrobot: refactor balatrobot cli (0a3390c)
• better api errors (617cbc9)
• checkpoints work (1e78386)
• client: add port option to client (4c7b912)
• client: add screenshot method (0ee8b8c)
• core: add boolean and table types to validator (54561d2)
• created savefile-based checkpointing (73ab99f)
• dev: add Makefile (02c569f)
• docs and types for checkpointing (5efff03)
• enhance rearrange jokers field in game state (e72c78e)
• finish buy_and_use_card docs (c644bab)
• fixtures: update generate.py to use httpx (abc2293)
• hook reroll_shop (0e533ae)
• improve CLI for replay bot (077178c)
• improved graphics settings for screenshots (86af829)
• log: hook for rearrange_consumeables (06f5be7)
• lua.core: add rpc.discover endpoint to the dispatcher (fa2f026)
• lua.core: add state name lookup table (6de65f4)
• lua.core: move from raw TCP to HTTP server (584aaf8)
• lua.endpoints: add add endpoint (d5e5e9c)
• lua.endpoints: add use endpoint (48fa0a1)
• lua.endpoints: add buy endpoint (3872f44)
• lua.endpoints: add cash out endpoint (c0aeeb5)
• lua.endpoints: add discard endpoint (7e25460)
• lua.endpoints: add gamestate endpoint (4ceb27c)
• lua.endpoints: add load endpoint ([c3e3d0d](c3e3d0d...