Skip to main content
Formal Specification

Klaverjas (Dutch Trump Card Game) — Formal Specification

Netherlands · card · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: directGap-fills: 2
# Klaverjassen — AI-optimized specification ## General idea A four-agent trick-taking game with imperfect information played in fixed partnerships (North-South vs. East-West) using a 32-card deck. Agents bid on trump selection and must follow intricate trick-play constraints (enforced following, overtrumping, and partner-protection differences between Amsterdam and Rotterdam rules) to score points and melds (*roem*). ## Formal model - **Abstraction taken:** None required; card deck, bidding, card values, and trick-taking mechanics are already a discrete mathematical game. - **Player/agent count:** 4 agents: P0,P1,P2,P3 (Partnerships: (P0,P2) vs. (P1,P3)). - **Turn model:** Sequential clockwise turns. ## Formal rules R1. **Deck and Deal:** Deck consists of 32 cards: {7,8,9,10,J,Q,K,A}×{♣,♢,♡,♠}. Each agent is dealt 8 private cards. R2. **Bidding Phase:** Starting from dealer +1(mod4), agents sequentially either `bid(suit)` or `pass()`. If all 4 pass twice, the hand is redealt by the next dealer [gap-fill]. The declaring team is marked Tdecl. R3. **Point Evaluation:** - **Trump values:** J=20,9=14,A=11,10=10,K=4,Q=3,8=0,7=0. - **Non-trump values:** A=11,10=10,K=4,Q=3,J=2,9=0,8=0,7=0. - **Last trick:** +10 points to winning team. R4. **Legal Play Set (Amsterdams Variant):** Given led card cled of suit Sled: - If agent holds cards of Sled, agent **must** play a card in Sled. - If agent has no cards of Sled: - If current winning card is held by teammate: agent may play **any** card. - If current winning card is held by opponent: agent **must** play a trump higher than the current highest trump if able (overtrump); if unable to overtrump, agent may discard any non-trump. - If trump is led: following agents holding trumps must follow trump and must overtrump if able. R5. **Roem Detection:** Automatically calculated upon trick collection: - 3-card sequence in suit = 20 pts. - 4-card sequence in suit = 50 pts. - 4 Jacks = 200 pts; 4 of A/K/Q/10 = 100 pts. - King + Queen of trumps (*Stuk*) = 20 pts (guaranteed). R6. **Hand Outcome:** - If declaring team total points >81 (and > opponent points): both teams record scored points + roem. - If declaring team total points ≤81: declaring team is *nat* (0 points + Stuk); opponents receive 162+all roem. - If a team wins all 8 tricks (*pit*): +100 bonus points. R7. **Rubber Win:** A match consists of H=16 hands. The partnership with the highest cumulative score wins. ## Edge cases - **Tie at the end condition:** If cumulative score after 16 hands is equal, 1 additional sudden-death hand is played [gap-fill]. - **A player with no legal move:** Impossible; hands start with 8 cards and legal action set per trick is strictly non-empty. - **Repetition / cycles:** Impossible; each trick consumes exactly 4 cards; cards never return to hands. - **Simultaneous claims on the same resource or position:** Not applicable; card plays and trick collections are strictly sequential. - **Player elimination mid-round; turn order repair:** Not applicable; all 4 agents participate in every trick. - **Resource exhaustion (pieces, tokens, space, time):** Hand terminates deterministically after 8 tricks (32 cards exhausted). - **Termination guarantee:** Guaranteed by finite 8-trick hand cycle and fixed 16-hand rubber limit. ## State representation - **Persistent state:** Hand number h∈[1,16], match scores (S0,S1), dealer index d∈{0..3}, trump suit. - **Per-hand state:** Trick number t∈[1,8], current trick cards [c0,c1,c2,c3], trick leader, declared roem list. - **Per-agent state:** Hand cards (set of up to 8 cards, private), partnership ID ∈{0,1}. - **Observable information:** Imperfect information. Public: played cards in current and previous tricks, declared bids, contract suit, roem declarations, cumulative scores. Private: own hand cards only. ## Action space - `bid(suit)`: Propose trump suit ∈{♣,♢,♡,♠}. Precondition: bidding phase. - `pass()`: Pass bidding opportunity. Precondition: bidding phase. - `play_card(card)`: Play a card from hand. Precondition: card ∈LegalActions(Hi,trick_state). ## Playability notes - **Single-player-vs-AI:** Natural; 1 human paired with 1 AI partner against 2 opponent AI agents using standard imperfect-information tree search (ISMCTS or neural heuristic). - **Group games (n>4):** Strictly a 4-player game; tournaments run duplicate tables with identical deals. - **Physical-skill games:** Zero physical skill; pure hidden-information tactical and probabilistic card reasoning. - **What is lost:** Table signals, hesitation timing, and social psychological bluffing. ## Implementation hints - Standard card game architecture. Card representations can use bitmasks (uint32). - First milestone: Implement legal play validator for Amsterdams and Rotterdams trumping rules and verify point/roem evaluation across 1,000 random deals.

Download as JSON

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

Download JSON
Cite this page

Klaverjas (Dutch Trump Card Game) (Netherlands). (n.d.). Games of Countries. https://gamesofcountries.com/games/nl-netherlands/klaverjassen

@misc{gamesofcountries-nl-netherlands-klaverjassen,
  title = {Klaverjas (Dutch Trump Card Game) (Netherlands)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/nl-netherlands/klaverjassen}
}