# Joker Index data sources

This is an unofficial, non-commercial fan reference for Balatro. Balatro, the
Joker names, and all Joker artwork are the property of LocalThunk and
Playstack.

The catalog contains 265 base-game entries from Balatro 1.0.1o: all 150
Jokers, 22 Tarot cards, 12 Planet cards, 18 Spectral cards, 32 Vouchers, 15
decks, 8 Enhancements, 4 Seals, and 4 Editions.

- Joker names, effects, rarity labels, and artwork were adapted from the
  [Balatro Sticker Tracker](https://github.com/humanfactors/balatro-stats),
  which credits the artwork and key mapping to the
  [Completionist++ Tracker](https://github.com/blackfan321/balatro-completionist-plus-plus-tracker).
- Base costs, collection order, availability flags, and the 150-card count were
  cross-checked against the source-derived
  [Auto-Balatro card registry](https://github.com/bangoz/Auto-Balatro/blob/main/data/balatro-card-registry.json).
- The complete catalog and effect wording were checked against the community
  [Balatro Wiki collection](https://balatrogame.fandom.com/wiki/Collection).
- Non-Joker structured data and compact collection artwork were cross-checked
  against [BalatroLab](https://balatrolab.com/en), whose database exposes the
  complete base-game collections as locally served media and structured facts.
- The official game and developer links are at
  [playbalatro.com](https://www.playbalatro.com/).

The site stores its own compact image and JSON files, so ordinary use does not
send requests to any of these sources.

## Optional mod libraries

Mod libraries are disabled by default and fetched only when selected. The
catalog currently includes 2,232 illustrated card entries whose localization
and atlas positions can be matched to an object registered by the corresponding
mod:

- 348 from [Cryptid](https://github.com/SpectralPack/Cryptid): Jokers, Tarot,
  Planet, Spectral, Code, Vouchers, Decks, Enhancements, and Editions
- 645 from [Pokermon](https://github.com/InertSteak/Pokermon): Jokers, Tarot,
  Spectral, Items, Energy, Vouchers, Decks, and Enhancements
- 118 from [Bunco](https://github.com/Firch/Bunco): Jokers, Tarot, Planet,
  Spectral, Polymino, Vouchers, Decks, Enhancements, and Editions
- 372 from [Paperback](https://github.com/Balatro-Paperback/paperback): Jokers,
  Planet, Spectral, Minor Arcana, E.G.O. Gifts, Vouchers, Decks,
  Enhancements, and Editions
- 749 from [All in Jest](https://github.com/survovoaneend/All-In-Jest): Jokers,
  Tarot, Planet, Spectral, Astral, Hex Tarot, Vouchers, Decks, Enhancements,
  and Editions

The current snapshot was generated on 2026-08-30 from commits `b1b60718d81a`
(Cryptid), `47587c978788` (Pokermon), `016e4cda5525` (Bunco),
`f40ee0de1b56` (Paperback), and `3f5a5d40a04b` (All in Jest).

Names and effect text come from each mod's English localization. Images are
cropped from the mod's 1x atlases, including any separate foreground or soul
layer, and remain the work of the respective mod artists. Internal-only
localization variants, ignored objects, collection previews, and vanilla
overrides are deliberately excluded. Some object families, such as modded
Editions, have no standalone collection artwork and therefore cannot appear as
separate illustrated entries. Placeholder values such as `[value 1]` represent
numbers the mod calculates at runtime and may vary with configuration or game
state.

The reproducible importer is in `scripts/import_mod_jokers.py`; it expects
checked-out mod repositories plus Python's Pillow and `slpp` packages.