Changelog

1.0.8 — 2026-05-07

• Fix Acrobat (×3 mult) and Dusk (retrigger all played cards) being skipped on the final hand of the round. Both jokers gate on G.GAME.current_round.hands_left == 0, but Balatro decrements hands_left before evaluate_play fires; at prediction time it still holds the pre-play value, so the condition failed and the predictor under-scored the last play. The analysis path now simulates the decrement when hands_left == 1.
• Capture a pre-scoring fixture when evaluate_play is invoked, so native crashes inside Balatro / SDL2 / love.dll (which bypass SMODS's love.errorhandler and leave no traceback in the lovely log) leave a crash_<ts>_N.lua behind with the exact inputs that triggered the fault. The file is deleted on normal return; only a true crash preserves it. batch_verify.lua ignores crash_*.lua since they have no actual_score.
• Force line buffering on stdout at mod load. Windows defaults to 4 KB block buffering for non-tty output, so miss / capture / F4-toggle messages could sit in the C runtime buffer for minutes (or until game exit) before reaching the lovely log. They now flush per line.

1.0.7 — 2026-05-06

• Fix Stone cards displaying as their underlying rank/suit (e.g. "6s") in the F2 Best Hands output. Stone cards retain their pre-conversion base.id / base.suit underneath the enhancement, and card_label was reading those directly. Scoring was unaffected — Stones now display as Stone.

1.0.6 — 2026-05-06

• F4 capture now retroactively grabs the most recent miss. Previously, players who only thought to enable capture after seeing a wrong prediction lost that hand permanently — F4-off skipped predict + compare entirely. The mod now always runs prediction and comparison; F4 only gates the disk write. While F4 is off, the latest miss is buffered in memory (single slot, newer overwrites older) and flushed to disk the moment F4 is toggled on. Buffer dies with the game.
• Hot-path perf: get_triggers reads retrigger joker counts from the per-call precomputed bundle instead of building a fresh joker_names list every call; straight detection drops a 14-element scratch array; eval_per_card_jokers' Bloodstone fallback skips a per-card allocation for non-Blueprint/Brainstorm jokers; Lucky Cat / Space Joker scans gated on presence flags. No effect on scoring — verified against 135 captures + 1000 synthetic fixtures.

1.0.5 — 2026-05-06

• Fix Blueprint (and Brainstorm) copying Supernova not getting the +1 pre-bump correction at the copy slot — vanilla joker_main reads hands[name].played pre-bump, so each copy was scoring one play short.
• Fix Blueprint (and Brainstorm) copying Card Sharp not synthesizing the X3 Xmult at the copy slot — vanilla returns nil pre-bump (because played_this_round > 1 reads the pre-bump value), so each copy was missing its X3.
• Fix Lucky Card's dollars-only roll outcome not bumping dollar_buffer, causing Bootstraps' joker_main to under-count by 2 mult per $5 of payout when that outcome was selected during enumeration.

1.0.4 — 2026-05-04

(1.0.3 was tagged but never shipped — BestHand.json was not bumped, so release.ps1 failed in CI. 1.0.4 contains the same fixes plus the version bump.)

• Fix Lucky Card's 1/15 dollars roll not bumping Lucky Cat — prob_config now enumerates that outcome (3 per Lucky card: none / mult / dollars-only) and the EV lucky_trigger rate is corrected from 1/5 to 19/75.
• Fix Wee Joker over-counting on debuffed 2s (e.g. The Pillar).
• Enumerate Space Joker's 1/4 hand-level upgrade as a probabilistic event instead of defaulting to no-upgrade.

1.0.2 — 2026-05-03

• Fix Blueprint (and Brainstorm) copying Baseball Card not contributing the second X1.5 mult per Uncommon joker — vanilla fires Baseball Card's context.other_joker reaction once for the real card and once for each copy.
• Fix Bootstraps (and Bull) reading stale G.GAME.dollars during analysis — vanilla get_p_dollars bumps dollar_buffer for Gold seals during the per-card phase, so the Phase-3 joker loop now mirrors that bump using the already-tracked scoring_dollars.

1.0.1 — 2026-05-01

• Removed dev-only debug keybinds (F5 timing, F6 face-down toggle) from the user README. They remain registered in dev installs only and are not part of the released mod.

1.0.0 — 2026-05-01

Initial release.

Hand analysis

• F2 — enumerates all k-subsets of the current hand and prints the top 2 scoring plays with point totals and card combos.
• Order-sensitive jokers (Hanging Chad, Photograph, Ancient Joker, Bloodstone, Triboulet, The Idol, Polychrome / Glass cards) trigger an exhaustive permutation search; the optimal left-to-right order is highlighted.
• Probabilistic jokers (Lucky Card, Bloodstone) contribute by expected value.
• F6 — ignore face-down cards (on by default). Cards flipped by The Wheel, The House, The Mark, and The Fish are excluded from analysis and held-in-hand effects.

Scoring fidelity

• Three-phase pipeline dispatched through Balatro's own Card:calculate_joker (context.before → per-card → context.joker_main), so each joker scores with the same code the game runs.
• Boss blinds modeled: The Eye, The Mouth, The Psychic, The Arm, The Flint.
• Held-in-hand effects: Steel Card, Baron, Shoot the Moon, with Mime / Red Seal retriggers.
• Blueprint and Brainstorm copy resolution including chained Blueprints.
• Four Fingers, Smeared Joker, Pareidolia, Splash, Shortcut.

Diagnostics

• F4 — fixture capture (off by default in released zips). Each played hand is compared against the game's actual score; mismatches are written to best_hand_captures/ for offline regression.
• F5 — debug timing for the F2 search and per-play prediction.