You are viewing a potentially older version of this package. View all versions.
Anto640-EngineSim-0.6.0 icon

EngineSim

Decision assistant: recommends the best play, discard, shop and pack choice from your deck, and can play whole runs by itself (F11). Single-player only.

Date uploaded 16 hours ago
Version 0.6.0
Download link Anto640-EngineSim-0.6.0.zip
Downloads 4
Dependency string Anto640-EngineSim-0.6.0

This mod requires the following mods to function

Thunderstore-lovely-0.10.0 icon
Thunderstore-lovely

Lovely is a runtime lua injector for LÖVE 2d

Preferred version: 0.10.0
Steamodded-Steamodded-26.1002.0 icon
Steamodded-Steamodded

A Balatro Modding Framework

Preferred version: 26.1002.0

README

Engine Sim — Decision Assistant & Self-Player

Engine Sim reads your live game and recommends the best move, with a reason: what to play or discard, what to buy, sell or reroll in the shop, which pack card to take, whether to skip a blind, and which consumables to use. It can also play whole runs by itself.

Every recommendation comes from measuring the options against your actual deck and jokers (Monte-Carlo over real hands, scored by a re-implementation of Balatro's scoring), not from a fixed tier list.

The advice panel in an Arcana Pack: it recommends The Tower, tags the card to apply it to (TARGET) and the pick (TAKE)

How to use it

Start a run. The advice panel sits at the top of the left HUD; hover it for the reason and stats. A small tag marks the recommended card, shop item or button.

Key Action
F9 Show / hide the panel
F11 Self-play on/off (the mod plays the run on its own advice)
F6 Auto-restart on/off (with self-play on, a finished run restarts after 4 s)

Settings (panel, tags, self-play speed): Mods → Engine Sim → Config.

Optional: with Handy installed, self-play skips animations and runs much faster. Without it, self-play still works at normal speed.

How good is it?

  • In its own headless simulator (Red Deck, White Stake) it wins about 41% of runs. That simulator is the project's model of the game, so treat it as a rough figure, not an in-game win rate.
  • Playing unattended in the real game, recent nights won 9 of 26 and 4 of 26 runs.
  • It is strongest at in-blind play and weakest at assembling a build (valuing jokers as a set).

Good to know

  • Single-player only. Don't use it in Balatro Multiplayer or any competitive setting. Under some bosses it can read face-down cards, which a human player can't.
  • It writes logs to your save folder (%APPDATA%/Balatro/): bes_runs.jsonl, bes_fixtures.jsonl and bes_autoplay.log. They stay on your PC and are only used to review its decisions.
  • Unofficial fan project. Not affiliated with or endorsed by Playstack or LocalThunk; it ships no game code or assets.
  • Built by Anto640 together with Claude (Anthropic), which wrote most of the code. It is open source (MIT): github.com/Anto640/balatro-engine-sim.

Maintenance is sporadic. Bug reports are welcome on GitHub but may wait.