Skip to main content
Formal Specification

Mus — Formal Specification

Spain · card · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: directGap-fills: 2
# Mus — AI-optimized specification ## General idea A four-agent imperfect-information card game played in fixed cross-partnerships with a 40-card Spanish deck (8 Kings, 8 Aces). Each hand consists of an optional mutual discard phase (*Mus*) followed by four sequential betting rounds (*Grande*, *Chica*, *Pares*, *Juego* / *Punto*). An all-in bet (*órdago*) allows an instantaneous showdown for the entire 40-point game. ## Formal model - **Abstraction taken:** Facial signaling (*señas*) is abstracted as an optional discrete private message channel between partners, where transmitting a signal carries an interception probability by opponents if unmasked. - **Player/agent count:** 4 agents arranged as Teams T1={A0,A2} and T2={A1,A3}. - **Turn model:** Sequential counter-clockwise turns starting with the *mano* (agent to the right of the dealer). ## Formal rules R1. Deck configuration: 40-card deck with values mapped to ranks: 12 and 3 → rank 8 (King); 11 → rank 7; 10 → rank 6; 7 → rank 5; 6 → rank 4; 5 → rank 3; 4 → rank 2; 1 and 2 → rank 1 (Ace). R2. Deal: Each agent receives 4 private cards. R3. Discard phase: In turn order, agents declare `mus` or `no_mus`. If all 4 declare `mus`, agents discard k∈[1,4] cards and redraw. Discards repeat until at least one agent declares `no_mus`. R4. Four lances sequence: 1. *Grande:* Lexicographic comparison of sorted 4-card hands descending. 2. *Chica:* Lexicographic comparison of sorted 4-card hands ascending. 3. *Pares:* Hand classification: Duples > Medias > Par > None. Only agents with ≥1 pair may participate in betting. 4. *Juego:* Sum of card points (Kings/Horses/Jacks =10, others face value, Aces/Twos =1). If any agent has sum ≥31, *Juego* is contested (31 > 32 > 40 > 37..33). If no agent has ≥31, *Punto* is contested (closest sum to 30). R5. Betting actions per lance: An agent may choose: - `pass`: If unbet, passes to next. If bet exists, declines (`no_quiero`, awarding current unaccepted bet or +1 *deje* to opponent). - `envido(n)`: Place a bet of n≥2 points. - `reengancho(n)`: Raise existing bet by +n. - `quiero`: Accept the current bet (resolved at showdown). - `ordago`: Bet the entire 40-point game. If accepted (`quiero`), all hands are revealed immediately, the active lance is evaluated, and the winning team receives 40 points, terminating the game immediately. R6. Showdown resolution order: If no órdago concluded the hand, accepted bets and bonus points are scored in strict sequential order: *Grande* → *Chica* → *Pares* → *Juego* / *Punto*. The instant a team reaches 40 points during this tally, the game ends immediately (later lances are not counted). R7. [gap-fill] Tie resolution: If opposing agents hold identical hand values in a lance, the tie is won by the agent holding positional advantage (*mano* seniority in turn order). R8. Win condition: The first team to reach 40 points wins the game (*juego*). ## Edge cases - **Tie at the end condition:** Not applicable; sequential scoring order (R6) and *mano* precedence (R7) guarantee that exactly one team crosses 40 points first. - **A player with no legal move:** Not applicable; pass, bet, accept, and fold are always exhaustively defined. - **Repetition / cycles:** Discard loops are bounded: [gap-fill] maximum 5 discard rounds before automatic `no_mus` is forced. - **Simultaneous claims on the same resource or position:** Not applicable; turns and betting responses are strictly sequential. - **Player elimination mid-round:** Not applicable; all 4 agents participate throughout. - **Resource exhaustion:** Deck reshuffles discards if shoe is exhausted during multiple mus cycles. - **Termination guarantee:** Guaranteed because unaccepted bets yield strictly positive points (+1) every hand, and showdown tallies add strictly positive points, ensuring one team reaches 40 in finite hands. ## State representation - **Persistent state:** `team_scores` {T1:0..40,T2:0..40}, `dealer_idx` (0..3), `mano_idx` (0..3). - **Per-hand state:** `hands` (array of 4 lists of 4 cards), `current_lance` (1..4), `pot_status` per lance (unbet, bet, accepted, folded), `current_bettor`. - **Observable information:** Private hand cards visible only to holding agent; discard counts, bidding calls, and scored points are public knowledge. ## Action space - `declare_mus(decision)`: Boolean `true` (mus) or `false` (no mus). - `discard_cards(indices)`: List of 1 to 4 card indices to replace. - `bid(action_type, amount)`: Where `action_type` ∈{pass,envido,reengancho,quiero,no_quiero,ordago}. ## Playability notes - **Single-player-vs-AI:** Natural; 1 human + 1 AI partner vs. 2 AI opponents. - **Group games (n>4):** Not applicable; Mus is mathematically closed at 4 agents (2v2). - **Physical-skill games:** Pure imperfect-information card game; no physical skill. - **What is lost in the adaptation:** Nuance of reading subtle physical facial micro-tells across a wooden table. ## Implementation hints Medium complexity. Perfect candidate for counterfactual regret minimization (CFR) or Monte Carlo Tree Search. First milestone: Implement 4-lance hand evaluator and deterministic sequential bidding state machine without discards, then add discard loops and scoring order.

Download as JSON

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

Download JSON
Cite this page

Mus (Spain). (n.d.). Games of Countries. https://gamesofcountries.com/games/es-spain/mus

@misc{gamesofcountries-es-spain-mus,
  title = {Mus (Spain)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/es-spain/mus}
}