Skip to main content
Formal Specification

Schnapsen (Austria's national card game) — Formal Specification

Austria · card · Confidence: high

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: directGap-fills: 1
# Schnapsen — AI-optimized specification ## General idea A two-player imperfect-information card game played with a 20-card deck. The game transitions dynamically between two distinct rule regimes: an open trick-and-draw phase where any card may be played, and a closed phase (triggered by exhausting the deck or by an agent actively "closing the talon") where strict trick-taking, suit-following, and trumping constraints apply. The goal is to reach 66 card points before the opponent. ## Formal model - **Abstraction taken:** None required (`direct` fidelity). The card mechanics, trick comparisons, marriage announcements, talon draw mechanics, and point evaluations are fully discrete. - **Player/agent count:** 2 agents (P1,P2). - **Turn model:** Sequential trick play (leader plays card, follower responds, trick resolves, winner leads next). ## Formal rules R1. Deck and Deal: Deck of 20 cards C={(rank,suit)|rank∈{A,10,K,O,U},suit∈{Eichel,Laub,Herz,Schellen}}. Point values: A=11,10=10,K=4,O=3,U=2. Each agent receives 5 private cards; 1 card is exposed as Trumpf (T); remaining 9 cards form the face-down Talon. R2. Phase 1 Play (Talon Open): - Active leader L may: 1. Declare Marriage: if holding (K,s) and (O,s), add +20 points (or +40 if s=T), and play one of them. 2. Exchange Trumpf: if holding (U,T) and on lead, exchange with the face-up trump card. 3. Close Talon: flip trump card face-down; transitions immediately to Phase 2. 4. Play Card: select any card from hand. - Follower F may play **any** card from hand (no suit/trick constraints). - Resolution: Card of suit led with highest value wins trick, unless trump played. Trick winner collects cards, draws top talon card, followed by loser drawing next card. R3. Phase 2 Play (Talon Closed or Exhausted): - Leader plays any card. - Follower must strictly obey: 1. Must follow suit led (Csuit=Lsuit). 2. If following suit, must win the trick if able (Crank>Lrank). 3. If unable to follow suit, must play a trump card (Csuit=T). 4. If unable to follow suit or trump, may discard any card. - No cards are drawn after tricks. R4. Reaching 66 Points / Win Claim: - At any point after winning a trick or making a marriage declaration, an agent with accumulated points≥66 may execute `claim_win()`. - If valid (points≥66): agent wins the hand: - 3 victory points if opponent scored 0 points. - 2 victory points if opponent scored 1–32 points. - 1 victory point if opponent scored ≥33 points. - [gap-fill] If a claim is invalid (points<66), opponent wins 2 victory points immediately (or 3 if opponent had 0 points). R5. Talon Closer Penalty: If an agent closed the talon but fails to reach 66 points before all cards are played or opponent claims 66, the opponent receives 2 victory points (or 3 if closer won no tricks prior to closing). R6. Last Trick Rule: If all cards are played without either agent claiming 66, the winner of the 10th trick wins the hand with 1 victory point. ## Edge cases - **Tie at the end condition:** If all tricks are played and neither hits 66, R6 awards the win to the winner of the final trick; true numerical draws are impossible. - **A player with no legal move:** In Phase 2, if no suit/trump can be played, any card is legally discardable; a hand is never without legal actions. - **Repetition / cycles:** Impossible; exactly 1 card is played per agent per trick, strictly reducing deck and hand sizes across at most 10 tricks. - **Simultaneous claims on the same resource or position:** Turns and claims are strictly sequential; only the active player on trick resolution can execute `claim_win()`. - **Player elimination mid-round; turn order repair:** Not applicable; 2-agent game. - **Resource exhaustion:** Talon exhausts after 5 tricks; game seamlessly transitions to Phase 2. - **Termination guarantee:** Provably terminates in at most 10 tricks (20 single-card actions). ## State representation - **Persistent state:** Victory point tally (V1,V2) counting down from 7 to 0; Bummerl count. - **Per-hand state:** Agent hands (H1,H2⊆C), Talon pile, Trump suit T, Talon closed flag ∈{false,true}, closer ID, trick point totals (S1,S2), current trick cards, marriage bonus totals. - **Observable information:** Imperfect information. Each agent observes own hand, face-up trump, face-up marriages, cards played in past tricks, and public score claims. Talon cards and opponent's hand are hidden. ## Action space - `play_card(card)`: Play designated card from hand. - `exchange_trump()`: Swap (U,T) for exposed trump card. - `close_talon()`: Close talon. - `declare_marriage(suit)`: Announce King+Ober in suit. - `claim_win()`: Declare 66 points reached. ## Playability notes - **Single-player-vs-AI:** Highly suitable; benchmark card game for Minimax, ISMCTS, and neural network imperfect-information AI. - **Group games (n>4):** 4-player extension exists as Bauernschnapsen (see `bauernschnapsen.md`). - **Physical-skill games:** Not applicable (pure discrete card game). - **What is lost in the adaptation:** Physical card fanning, bluffing body language, and table-slapping tavern gestures. ## Implementation hints - Implement as a discrete imperfect-information tree. - Suggested first milestone: Implement the 20-card deck and trick comparison logic with open talon before implementing the Zudrehen state machine.

Download as JSON

Download the full game corpus entry for this game as structured JSON.

Download JSON
Cite this page

Schnapsen (Austria's national card game) (Austria). (n.d.). Games of Countries. https://gamesofcountries.com/games/at-austria/schnapsen

@misc{gamesofcountries-at-austria-schnapsen,
  title = {Schnapsen (Austria's national card game) (Austria)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/at-austria/schnapsen}
}