Vacuum Lobby Manual

The Lobby is where you sign in, find games, create a game, choose seats, and enter as either a player or watcher. The Lobby Manual and Rules remain available before login.

Accounts and recovery keys

Create Account asks for a username and password. A display name is optional; if omitted, your username is displayed. A recovery key is created for account recovery. Save it somewhere private: it is a credential, not a game invitation. Creating a replacement recovery key invalidates the old key. Vacuum never prints a real recovery key in either manual.

A login session lasts 30 minutes without deliberate player activity. The yellow timer below the player name shows the remaining time and turns red below 30 seconds. Clicking it renews the session. Deliberate clicks or keyboard actions by signed-in players renew it too; passive polling, pointer movement, and watching do not. At zero, Vacuum logs the account out. While the Lobby tab is hidden or unfocused, its visual countdown and ordinary game-list polling pause; the real expiration time continues, and the Lobby refreshes immediately when you return.

Game list

Each row identifies the game, host, seating, state, and the action available to you. Your Turn opens a begun game when one of your colors is active. Not Your Turn is yellow. Waiting Room opens seating before play. The illustrated watch and game-over keycaps are still buttons even though they use pictures instead of ordinary captions.

The five Conditions—Watch Only, Free Seats, Hosted by Me, My Seat, and Begun—cycle through positive, negative, and --- (unused). All active conditions must match. Sorting and seat-count grouping change presentation only.

Creating and seating a game

1. Create a game and choose two, three, or four players.
2. Seats are ordered Red, Green, Orange, Yellow. A two-player game therefore uses the diagonal Red and Green corners; a three-player game adds Orange.
3. In the Waiting Room, take or leave seats. Changes remain local until Apply.
4. When every required seat is filled and you control Red, Apply becomes the green Start Game button. One click applies any pending seat changes, starts the game, and opens the board. Filling the final seat as another color does not start the game; Red starts it.
5. Every successful Apply—including the Apply performed by Start Game—counts as meaningful activity, even if a later Apply restores an earlier arrangement.

Invite copies a direct link in both ordinary text and rich-button form where the browser permits. A signed-out invite recipient is returned to that Waiting Room after login or account creation.

Players, watchers, and abandoned games

Players with a seat may act only for colors they own. Watchers are read-only and cannot keep a game or login session alive merely by watching. Creating a game, committing gameplay, changing game metadata, or successfully applying seats resets the game’s 14-day inactivity clock. Opening, listing, spectating, and polling do not. After 14 full inactive days, the game is removed.

Loading and troubleshooting

Keep the loading screen in place while the Lobby or game is restoring state. If a connection genuinely fails, use the displayed retry or return option instead of repeatedly opening new tabs. An ordinary refresh should request the authoritative saved board; matching repeated save acknowledgements are not treated as an out-of-sync error.

Game pictures are served with no-store cache headers, so replacing a keycap image under the same filename should not require changing or recompiling the program. A browser or proxy may still briefly retain an earlier response; one normal reload should fetch the replacement after deployment.