balatro-seed-search/README.md

2.7 KiB

Balatro Seed Search

A native Rust command-line tool for finding and inspecting Balatro seeds by joker, ante, boss, voucher, tag, pack contents, card properties, and other run conditions. It is intended for seed hunters who want a fast, scriptable search without a browser or graphical interface.

Requirements and build

Install a current stable Rust toolchain, then build from the repository root:

git clone https://proxy.dandaedre.com/gitea/MadGobblins/balatro-seed-search.git
cd balatro-seed-search
cargo build --release --locked --bin balatro-seed-search

The binary is written to target/release/balatro-seed-search.

Quick start

Find the first seed in a small range containing Blueprint on or before ante 2:

./target/release/balatro-seed-search find-jokers \
  --joker Blueprint --before-ante 2 \
  --max-seeds 1000 --max-matches 1 --threads 1 \
  --progress 0 --output seeds

Expected standard output:

11111122

--before-ante is inclusive. Repeat --joker to require multiple jokers, or add --mode any to accept any requested joker. Run balatro-seed-search find-jokers --help for every available search control. Use --pack-joker NAME to search Buffoon-pack contents instead of shop slots.

Shop results use the post-1.0.1c joker pools and report positions in an ante's shop queue. --max-rerolls assumes one two-card shop visit; purchases, unlocks, and later visits are not simulated. See correctness limits.

Documentation

Credits, license, and support

The original seed-search engine and application were created by Julie (JupiterianSoul). All credit for the original Rust engine, Balatro RNG implementation, derivation logic, filters, tables, validation tools, and initial application belongs to her. Later work repackages and extends that foundation as a native-only CLI.

This project preserves Julie's MIT license. Report bugs and request features in the canonical Gitea issue tracker.