Skip to main content
Formal Specification

Slovak Chosen Mariáš — Formal Specification

Slovakia · card · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: directGap-fills: 1
# Slovenský volený mariáš — AI-optimized specification ## General idea A high-depth asymmetric trick-taking card game played with a 32-card German-suited deck where 1 Declarer chooses trump and discards 2 cards into a private talon, then attempts to fulfill a chosen contract against 2 cooperating Defenders under mandatory trick-taking constraints (must-follow, must-head, must-trump). ## Formal model - **Abstraction taken:** None required; the traditional rules of the Slovak Union of Mariáš Clubs (SZMK) form a complete, discrete, deterministic finite-state game. [gap-fill] Standard contract set is restricted to Basic Game, Seven (*Sedma*), Betl, and Durch. - **Player/agent count:** Exactly 3 agents (Agent 0: Declarer / Forhond; Agents 1, 2: Defenders). - **Turn model:** Sequential counter-clockwise turns across 10 trick rounds. ## Formal rules R1. Deck Structure: 32 cards: 4 suits S∈{Červene, Zeleň, Žalude, Gule}, 8 ranks R∈{7,8,9,10,Dolník,Horník,Kráľ,Eso}. R2. Deal: Dealer deals 7 cards to Declarer, 5 cards each to Defender 1 and Defender 2. Declarer declares trump suit T∈S. Dealer completes deal: 5 more cards to all 3 agents (Declarer has 12 cards; Defenders have 10 each). R3. Discard: Declarer discards 2 non-scoring cards to the private talon. Aces and Tens cannot be discarded unless the hand contains no other legal cards. R4. Contract Declaration & Doubling: Declarer announces contract C∈{GAME, SEVEN, BETL, DURCH}. Defenders choose whether to double (`FLAK`). R5. Trick Play Rules (Strict Hierarchy): - Lead: Active leader plays any card c1. - Response: Following agents must obey the priority order: 1. Follow suit led: Must play card of same suit S(c1). 2. Must head: If following suit, must play a higher card of that suit if held. 3. Must trump: If void in led suit, must play a card of trump suit T (and must overtrump any existing trump on the table if possible). 4. Discard: If void in led suit and trumps, may play any card. - Resolution: Highest trump wins the trick; if no trump played, highest card of led suit wins. Winner collects all 3 cards and leads to the next trick. R6. Marriages (*Hlášky*): When leading or playing the first card of a King-Over pair in hand, the agent declares the marriage: +20 points (+40 if in trump suit). R7. Scoring: - Card Points: Each Ace and Ten collected in tricks = 10 points. Last trick = 10 points. Maximum base trick points = 90. - Contract Fulfillment: - `GAME`: Declarer wins if Declarer_Points>Defender_Points. - `SEVEN`: Declarer wins if they take the 10th trick with the Trump 7. - `BETL`: Declarer wins if they take 0 tricks (no trumps; rank order changes to standard: A, K, H, D, 10, 9, 8, 7). - `DURCH`: Declarer wins if they take all 10 tricks. ## Edge cases - Tie at the end condition: In a basic `GAME` contract, if points are tied (e.g. 50–50 without marriages), the defense wins (Declarer loses on a tie) per official SZMK rules. - A player with no legal move: Not applicable; an agent with cards in hand always has at least one card satisfying the legal filter (R5). - Repetition / cycles: Exactly 10 tricks of 3 cards each are played; deck is completely consumed; zero cyclical possibility. - Simultaneous claims on the same resource or position: Turns are strictly sequential counter-clockwise. - Player elimination mid-round; turn order repair: No eliminations; all 3 agents play all 10 tricks. - Resource exhaustion (pieces, tokens, space, time): Deck contains exactly 32 cards, partitioned into 10-card hands and a 2-card talon. - Termination guarantee: Exact 10-trick cycle count guarantees termination. ## State representation - Persistent state: `declarer_id: int`, `trump_suit: int`, `contract: int`, `talon: list[Card]`, `cumulative_scores: list[int]`. - Per-trick ephemeral state: `current_trick: list[tuple[int, Card]]`, `cards_in_hand: dict[int, list[Card]]`, `tricks_won: dict[int, list[list[Card]]]`, `declarations: dict[int, list[int]]`. - Observable information: Incomplete information — agents observe only their own hand, cards played in public tricks, and announced marriages/contracts. Discarded talon cards are private to Declarer. ## Action space - `declare_trump(suit: int)`: Select trump suit S∈{0,1,2,3}. - `discard_talon(c1: Card, c2: Card)`: Discard 2 valid cards. - `announce_contract(contract_id: int)`: Select contract. - `play_card(c: Card)`: Play card c satisfying legal constraints of R5. ## Playability notes - Single-player-vs-AI: Exceptional environment for card-playing AI (imperfect information, MCTS / CFR, partner coordination). - Group games (n>4): Not applicable; strictly a 3-agent game. - Physical-skill games: Not applicable (`direct` fidelity class). - What is lost in the adaptation: Table psychology, facial tells, card flicking style. ## Implementation hints Medium complexity. The legal-move generator (Must-Follow, Must-Head, Must-Trump) is the critical component and must be rigorously unit-tested against SZMK tournament edge cases. First milestone: implement the 32-card deck and trick resolution engine before adding contract doubling.

Download as JSON

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

Download JSON
Cite this page

Slovak Chosen Mariáš (Slovakia). (n.d.). Games of Countries. https://gamesofcountries.com/games/sk-slovakia/marias

@misc{gamesofcountries-sk-slovakia-marias,
  title = {Slovak Chosen Mariáš (Slovakia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/sk-slovakia/marias}
}