Record the two ways the mod silently vanishes from a boot

The Mods symlink pointed at the repo's pre-rename home and the loader
skipped the mod without a word of complaint - every smoke check failed
with no JCA global before the link was repointed. Document that, the
BMM-disable marker that looks identical (.lovelyignore in the mod
folder), the real Steam library (/mnt/games), and where to re-clone
the smoke harness from.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
funman300
2026-07-14 13:54:07 -07:00
parent 2b43d24994
commit 2c47449b13
+13 -4
View File
@@ -66,9 +66,16 @@ acting on one.
`~/.local/share/Balatro/Mods/JokerComboAdvisor -> ~/Documents/JokerComboAdvisor`
(this repo). Edits here go live on next game launch — do not copy files anywhere.
Lovely reads that folder as `C:\users\steamuser\AppData\Roaming\Balatro\Mods`.
- Game: Steam/Proton at `~/.local/share/Steam/steamapps/common/Balatro`. Lovely
injector + Steamodded 1.0.0-beta are already installed; mods are managed via
Balatro Mod Manager.
The link used to point at the repo's pre-rename home (`~/Documents/Balatro Mod`);
when that path died the loader silently skipped the mod — **if the game boots
with no JCA in the log at all, check this symlink first.** A disabled-in-BMM
mod looks the same way (SMODS drops a `.lovelyignore` file into the mod folder
to disable it — never create one at the repo root).
- Game: Steam/Proton, installed in the `/mnt/games/Steam` library (not the
default one — its save prefix is
`/mnt/games/Steam/steamapps/compatdata/2379780/pfx/.../Roaming/Balatro`).
Lovely injector + Steamodded 1.0.0-beta are already installed; mods are
managed via Balatro Mod Manager.
- Crash/load logs: `~/.local/share/Balatro/Mods/lovely/log/` (newest file).
- Remote: `https://git.aleshym.co/funman300/JokerComboAdvisor` (private, user's
Gitea). `git push` just works: it authenticates through the global libsecret
@@ -246,7 +253,9 @@ pipeline, a real overlay `UIBox` — with no clicking:
It boots the game, runs `scenarios/JokerComboAdvisor.lua`, quits, and prints a
pass/fail report (non-zero exit on failure). Close Balatro first; it needs a clean
boot. Scenarios live in the harness repo, not here.
boot. Scenarios live in the harness repo, not here. If `~/Documents/BalatroSmoke`
is missing, clone it: `git clone https://git.aleshym.co/funman300/BalatroSmoke.git
~/Documents/BalatroSmoke` and symlink it into the Mods folder like any mod.
It covers the surfaces this repo's tests cannot reach: the hover tooltip naming a
partner, the clash and caution lines, discovery on emplace, and — the reason it