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
- Search guide: joker searches, named seeds, inspection, output formats, and shell completions.
- Advanced filter format: JSON filters for every engine clause.
- Correctness and limitations: modeled behavior and parity boundaries.
- Performance: measured thread scaling and the SIMD decision.
- Development and releases: quality checks, benchmarks,
and
rust_realeaseusage. - Acceptance record: reproducible native CLI examples and quality-gate results.
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.