Formal Specification
Tunisian Fishing Card Game — Formal Specification
Tunisia · card · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: directGap-fills: 1
# Chkouba Tounissia — AI-optimized specification
## General idea
A turn-based card fishing game played with a 40-card Italian/Spanish-suited deck. Players play 1 card per turn to capture table cards via direct rank match or subset sums equal to the played card's rank. Sweeping the table scores an immediate *Chkouba* point; end-of-round points are awarded across 4 standard categories.
## Formal model
- **Abstraction taken:** Direct discrete formalization. 40-card deck with suits `{Coins, Cups, Swords, Clubs}` and ranks `{1..7, 8(Jack), 9(Knight), 10(King)}`.
- **Player/agent count:** 2 players (0 and 1).
- **Turn model:** Sequential alternating turns across 6 deals of 3 cards each.
## Formal rules
R1. Setup: 40-card deck is shuffled. 4 cards are dealt face up to `Table`. 3 cards are dealt to each player's private `Hand`.
R2. Turn Action: Active player plays 1 card `C` from hand.
R3. Capture Matching Rules:
- Match Priority: If `rank(C)` equals `rank(T)` for any single `T in Table`, player MUST capture that single card `T` (plus `C`).
- Subset Sum Match: If no single card matches, but a subset `S subseteq Table` satisfies `sum(rank(s) for s in S) == rank(C)`, player captures `S cup {C}`.
- If multiple subset sums exist, player selects one.
- If no capture is possible, `C` is placed face up on `Table`.
R4. Chkouba Sweep: If a capture results in `Table == empty` AND it is not the final card of the 40-card deck, the player scores `+1 Chkouba point`.
R5. Redeal & Round End:
- When hands are empty, deal 3 cards to each player until all 40 cards are played.
- Remaining table cards are awarded to the player who made the last capture.
R6. End-of-Round Scoring:
- `Cards`: 1 point if `count(WonCards) > 20`.
- `Coins`: 1 point if `count(Coins) > 5`.
- `SevenOfCoins`: 1 point to owner of `(Coins, 7)`.
- `Primiera`: 1 point to player with highest Primiera score (using classical values: 7->21, 6->18, 1->16, 5->15, 4->14, 3->13, 2->12, 10/9/8->10 per suit).
- Plus all `Chkouba` sweep points accumulated during play.
R7. Win Condition: Points accumulate across rounds. First player to reach 11 points wins.
## Edge cases
- Tie at the end condition: [gap-fill] If both players reach or exceed 11 points simultaneously with tied scores, additional rounds are played until the tie is broken.
- A player with no legal move: Not applicable; a player always holds at least one card during active turns.
- Repetition / cycles: Bounded strictly by 40 cards per round and 6 deals.
- Simultaneous claims on the same resource or position: Sequential turn execution.
- Player elimination mid-round; turn order repair: Not applicable; 2-player format.
- Resource exhaustion: Exactly 40 cards exhausted per round.
- Termination guarantee: Enforced by finite card counts and positive point increments.
## State representation
- Persistent state: `match_scores: Array[2][int]`, `round_num: int`.
- Round state: `deck: List[Card]`, `table: List[Card]`, `hands: Array[2][List[Card]]`, `captured: Array[2][List[Card]]`, `chkouba_points: Array[2][int]`, `last_captor: Optional[int]`.
- Observability: Imperfect information; `Table` and trick counts are public; opponent hand is private; undealt deck is hidden.
## Action space
- `play_card(card_index, chosen_subset_capture)`.
## Playability notes
- Single-player-vs-AI: Engine-ready; standard candidate for IS-MCTS or heuristic rule-based AI.
- Group games (n>4): Extends naturally to 4-player partnership play (2v2).
- Physical-skill games: Pure imperfect-information card strategy.
- What is lost: The theatrical café atmosphere of slamming the winning *Seb'a el-Haya* onto the table.
## Implementation hints
Discrete card state machine. First milestone: implement subset-sum combination finder and exact Primiera evaluation logic.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Tunisian Fishing Card Game (Tunisia). (n.d.). Games of Countries. https://gamesofcountries.com/games/tn-tunisia/chkouba-tunisia
@misc{gamesofcountries-tn-tunisia-chkouba-tunisia,
title = {Tunisian Fishing Card Game (Tunisia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/tn-tunisia/chkouba-tunisia}
}