Antelytics

A Balatro run recorder. Made by Chrono.

Antelytics records every decision you make during a run — blinds, hands, discards, shop buys, packs, PvP scoring — and writes it to a single compressed file. Open that file in the Antelytics viewer to step back through the whole run, ante by ante. Built with Balatro Multiplayer in mind (it captures PvP scores and lives), but it works on solo runs too.

---

Install

Requirements

• Steamodded 1.0.0-BETA-1221a or newer
• (optional) Balatro Multiplayer — needed only for PvP capture

Option A — mod manager (r2modman / Thunderstore Mod Manager)

Install Antelytics from Thunderstore inside the manager. It pulls in Steamodded and lovely for you. Launch Balatro with the manager's Start modded button — the manager runs the game against its own profile folder, so nothing is copied into your real Balatro folder. Mod managers currently exist for Windows and Linux only — on macOS use Option B.

Option B — manual

1. Download the latest Antelytics.zip from the Releases page.

2. Extract it. You'll get an Antelytics folder containing main.lua and Antelytics.json.

3. Drop that folder into your Balatro Mods directory:

   OS	Mods folder
   Windows	%APPDATA%\Balatro\Mods\
   macOS	~/Library/Application Support/Balatro/Mods/
   Linux	~/.steam/steam/steamapps/compatdata/.../Balatro/Mods/

   The result should be …/Mods/Antelytics/main.lua.

4. Launch Balatro. If it loaded, Antelytics shows up in the in-game Mods list.

Where the files end up

Antelytics writes its run files to a log folder next to wherever it was installed — it asks Steamodded for its own location, so both install methods work without any configuration. The two methods just put the mod in different places:

Install method	Mod folder	Run files
Manual	…/Balatro/Mods/Antelytics/	…/Balatro/Mods/Antelytics/log/
r2modman	<profile>/mods/Chrono-Antelytics/	<profile>/mods/Chrono-Antelytics/log/

<profile> is the manager's profile directory: in r2modman use Settings → Browse profile folder. By default that is %APPDATA%\r2modmanPlus-local\Balatro\profiles\<profile name>\ on Windows. A manual copy and a manager copy don't see each other; whichever way you launch the game is the one that records.

---

How to use it

1. Play a run. Antelytics records it automatically — nothing to turn on.

2. When you want to review it, find your run file in the mod's log folder (see Where the files end up above):

   Install	Log folder
   Manual, Windows	%APPDATA%\Balatro\Mods\Antelytics\log\
   Manual, macOS	~/Library/Application Support/Balatro/Mods/Antelytics/log/
   r2modman	<profile>\mods\Chrono-Antelytics\log\ (Settings → Browse profile folder)

   Files are named <timestamp>_<random>.json.gz. The run's seed is written into the file only once the run is over, so an in-progress file never reveals it.

3. Open www.antelytics.gg and load that file (the ↑ Load run button, or drag-and-drop). Step through your run ante by ante.

Each run file updates at every blind boundary, so you can even open an in-progress run.

Coaching / sharing notes

In the viewer you can add a comment on any step, then ↓ Notes to download the run bundled with your comments as one file. Hand it to a coach (or teammate) — they open it, reply on the steps, download again, and send it back. Annotated steps are marked on the timeline so they're easy to find.

---

What it captures

• Blind select (play / skip-with-tag), play hand & discard (with hand type)
• Buy / sell / use consumable, reroll, pack open & pick
• End-of-round cash-out, blind defeated, shop contents
• PvP (with Balatro Multiplayer): your & the opponent's scores and lives each step, who won each PvP blind, and the match result

Every step also snapshots money, score, jokers, consumables, deck, hand levels, vouchers and tags — everything needed to reconstruct the run state.

---

Feedback & bugs

Open an issue: New issue → (there's a form for both the mod and the website).

---

Building from source (developers)

git clone https://github.com/ChronoFinale/BalatroAntelytics
cd BalatroAntelytics

# Run the tests (needs https://lunarmodules.github.io/busted/)
busted spec/

# Install into your Mods folder (COPY, never symlink — Balatro holds files
# open at runtime; a symlink into a working tree can corrupt a mid-game capture)
pwsh ./install.ps1        # Windows
./install.sh              # macOS / Linux

# Build a release zip (writes dist/BalatroAntelytics.zip)
pwsh ./package.ps1        # Windows
./package.sh              # macOS / Linux

Releases are cut by pushing a v* tag — see .github/workflows/release.yml.

License

GPL-3.0