A transient "verification pending" refusal on socket rejoin drops the lobby and replays the whole run mid-match
Maintainers usually reply within 2 days
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 25/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Active
- Tech stack
- lua
- Domain
- api, backend-api-design
Research direction
Start with networking/nakama_lobby.lua and trace schedule_rejoin and with_socket; then read networking/connection.lua around start_launcher_verification. The issue identifies ui/reconnect_prompt.lua, api/playback/rejoin.lua, and the fix/live-run-reattach branch as the live run recovery path. Confirm which proposed fixes are still needed, then test a two-player disconnect and rejoin during a PvP blind; done means the lobby recovers without replaying over the live run and the player gets a notice if the match is gone.
Written by the indexing model from the issue text.
Description
Summary
Players report a "Checking your game..." overlay appearing at random during a match, followed by the whole game replaying from the start. It usually ends in a softlock, with the player left in a singleplayer/practice-style lobby outside the PvP blind.
Traced from one affected player's Lovely log (lovely-2026.11.04-11.33.54.log) plus the code. The code path is solid; the exact trigger on the server side is inferred (see "Not confirmed").
What happened (log timeline)
12:20:22 [nakama_lobby] socket error: standing_refused:{"reason":"verification_pending", ... "Launcher verification is still pending. Try again in a moment."}
12:20:22 [nakama_lobby] lost lobby EGLWG: standing_refused:{"reason":"verification_pending", ...}
12:20:34 replay starts (get_next_tag_key diagnostics)
12:20:40 playback hand_result mismatch: recorded=25 real=0 (x4, see note below)
12:21:40 ERROR :: MULTIPLAYER :: No next blind context
The replay starts about 12s after the refusal, which matches the up-to-15s launcher-verdict wait (S.VERDICT_WAIT_SECONDS).
Cause (three problems chained together)
- A transient refusal is treated as final. After a socket drop,
schedule_rejoin(networking/nakama_lobby.lua) retriesmatch_joinon a backoff, but only for transport failures. Any other error goes tofollow_seat, and if the server still reports the same match it callslose(err), which tears the lobby down.verification_pendingsays "Try again in a moment" but takes that final path, so a lobby that is still seated is destroyed. - Launcher verification is not refreshed when the lobby socket is reopened.
start_launcher_verificationis called only on first login (networking/connection.lua:467) and fromverify_again.with_socketinnakama_lobby.luadoes not restart it, so the rejoin can hit the server with no current verdict. (Inferred: the server's rule is not in this repo.) - The reconnect flow assumes any seat with a recorded run means a relaunch.
lost->show_rejoin_refused-> "Checking your game..." ->verify_again->reconnect_to->MPAPI.playback.rejoin(ui/reconnect_prompt.lua,api/playback/rejoin.lua). That flow is the crash-recovery path. It boots a second local run (as a practice lobby) over the run still on screen, fast-forwards the log into it, and only swaps in the real lobby ingo_live. If the replay does not finish, the player stays in the local lobby. That is the "singleplayer lobby" players describe.
Related smaller findings
Match not foundshows no message. In the same log (11:55:44,lost lobby QKUYU: Match not found) the match really was gone. Giving up is right, but thelosthandler inapi/lobby/nakama.luashows a notice only for a forfeit, a timeout, or a standing refusal, so the player is left in an orphaned run with nothing on screen.- The
hand_result mismatch ... real=0warnings are a false positive, not replay drift. The HAND_RESULT handler in the PvP mod compares againstPVP.GAME.score, which is set only byPVP.ACTIONS.play_hand, and that is skipped in practice mode (which the rejoin replay uses). So the field is always nil. This is in the PvP repo and is tracked there. - Possibly related to #58 (reconnecting leaving game speed at 64x), since both involve the rejoin fast-forward. Not verified.
Proposed fixes
- Retry
verification_pendinginstead of giving up. Inschedule_rejoin, treat it as retryable: start launcher verification once, then retry within the grace window. Only permanent reasons (mods_not_allowed,verification_failed, a forfeit) should calllose(). - Verify before the join. When
with_socketreopens a socket for a lost match, restart launcher verification and wait for the verdict before sendingmatch_join. - Do not run the crash replay over a live run. If only the lobby was lost and the run is still on screen and recording, rejoin the seat into that run. Keep the fast-forward for a real relaunch. This is implemented on branch
fix/live-run-reattach(commit 0d99dfe), no PR opened. - Tell the player when the match is gone (
Match not found), and offer to leave the run.
The branch change remembers the lobby when it is lost with its run live and recording (MPAPI.playback.remember_dropped_lobby). rejoin() in ui/reconnect_prompt.lua then calls MPAPI.playback.reattach_live_run, which takes the seat back without a fast-forward. It carries over the unsent replay events and the gamemode instance from the old lobby. It does not address 1, 2 or 4.
Not confirmed
- Server-side rule. I could not see why the server reports
verification_pendingafter a rejoin (whether the verdict is per socket session or has expired). Fixes 1 and 2 are written to work either way, but the server repo should confirm. - The branch has not been run. It only parses as Lua. It needs a two-player test: drop the connection during a PvP blind, then rejoin.
- Replay events recorded while no lobby exists are not recovered. Only events kept on the old lobby object are resent, so the server's log may have a gap there. How the server treats that (end-of-match hash check) is unknown.
- PvP's
attachhook on a live run. It callsPVP.setup_lobby_mirror, which I have not checked for resetting score, timers or ready state mid-blind. - The trigger for the original socket drop is not visible in the log.
- Dominant language
- Lua
- Stars
- 10
- Forks
- 8
- Avg merge
- 1d 18h
- Merged PRs (30d)
- 20
Getting set up
- No Dockerfile or Docker Compose file
- No pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from Balatro-Multiplayer/BalatroMultiplayerAPI
-
Difficulty 2/5 1-3 hours Newbie friendliness 63/100
Balatro-Multiplayer/BalatroMultiplayerAPI#55 ·
Maintainers usually reply within 2 days
-
Difficulty 4/5 3-5 days Newbie friendliness 45/100
Balatro-Multiplayer/BalatroMultiplayerAPI#61 ·
Maintainers usually reply within 2 days
-
Difficulty 3/5 1-2 days Newbie friendliness 57/100
Balatro-Multiplayer/BalatroMultiplayerAPI#58 ·
Maintainers usually reply within 2 days
-
Difficulty 3/5 1-2 days Newbie friendliness 45/100
Balatro-Multiplayer/BalatroMultiplayerAPI#57 ·
Maintainers usually reply within 2 days
-
Difficulty 3/5 1-2 days Newbie friendliness 52/100
Balatro-Multiplayer/BalatroMultiplayerAPI#56 ·
Maintainers usually reply within 2 days
All issues in Balatro-Multiplayer/BalatroMultiplayerAPI
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
nvim-tree/nvim-tree.lua#3383 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 83/100
Maintainers usually reply within 2 days
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
Balatro-Multiplayer/BalatroMultiplayerPvP#620 ·
Maintainers usually reply within 1 day
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
silverbulletmd/silverbullet#2231 ·
Maintainers usually reply within 2 days