CUSTOMSPYFALL

The host creates a room, picks which locations are in play (from 52 built-ins or a custom CSV), sets the round timer (3–15 min), and chooses how many spies (1–3).

At the start of a round, one or more players are secretly assigned as Spy. Spies see no location and do not know who the other spy is (if there are multiple). All other players — the Agents — see the location and a unique role within it.

Players take turns asking each other one question at a time. Agents must answer convincingly without revealing too much about the location. The spy must bluff without giving themselves away — while secretly trying to figure out where they are.

The current player picks who to ask next. To request a turn, raise your hand (✋) — the host can grant it. The host can also advance turns manually.

Any player can press READY TO VOTE. Once enough players are ready (all agents), voting starts automatically. Press WHO? to see which players have marked themselves ready. The host can also force a vote at any time with START VOTE.

Each player votes for who they think is the spy. A majority (>50%) is required to catch the spy. A tie or insufficient majority means the spy escapes. You can see who has already voted (✓ VOTED) during the voting phase.

After every vote — regardless of outcome — the spy gets 30 seconds to guess the location. A correct guess always earns bonus points.

Spy caught: Each agent earns +2 pts. Spy earns +1 consolation pt if they correctly guess the location.

Spy not caught (survived vote or tie): Spy earns +2 pts plus +1 extra pt for a correct location guess. Agents who voted for the spy earn +1 pt.

LOCATIONS tab: Cross out locations you've ruled out — they get a strikethrough so you can track your deductions.

PLAYERS tab: Cross out players you've cleared from suspicion to narrow down your suspects.

Press HINTS during a round to get suggested questions you can ask — useful if you're not sure what to say. Each hint has a cooldown before another can be requested.

The results screen shows the spy reveal, location, vote breakdown, and scoreboard with points earned this round. The host can pick PLAY AGAIN to start a new round — between rounds the host can enable or disable individual locations in the picker.

A full Round History is always visible in the lobby, showing every round's spy, location, outcome, and per-player earnings.

Spectators can join a room without playing — they see the location and spy names in real time.

COMMS is an in-game chat available on all screens throughout the session.

As an agent: ask questions that test specific knowledge of the location — the spy won't know the right answer. As the spy: every question asked is a clue — listen carefully to piece together where you are before the vote.

One or more players are secretly assigned the role of Spy — they don't know the location. Everyone else knows exactly where they are and what role they play.

Players take turns asking each other questions to sniff out the spy. The spy must answer convincingly without giving themselves away — while secretly trying to figure out the location before the vote.

At any point the host can call a vote. If the majority correctly identifies the spy, the agents win. If the spy guesses the location correctly before being caught, the spy wins.

CustomSpyFall lets you bring your own locations via CSV upload. Any column after Location becomes a role — no special column names needed.