Formal Specification
Algerian Fishing Card Game — Formal Specification
Algeria · card · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: directGap-fills: 1
# Chkouba Djazairia — AI-optimized specification
## General idea
A turn-based card fishing and trick-taking game played with a 40-card Spanish-suited deck. Players play 1 card per turn to capture table cards via direct rank match or subset sum matching. Clearing all table cards scores an immediate bonus point (*Chkouba*); end-of-round points are awarded for majority cards, majority coins, the 7 of Coins, and best Primiera.
## Formal model
- **Abstraction taken:** Direct discrete formalization. Card deck consists of 40 cards: 4 suits `{Coins, Cups, Swords, Clubs}` with ranks `{1..7, 8(Jack), 9(Knight), 10(King)}`.
- **Player/agent count:** 2 players (0 and 1).
- **Turn model:** Sequential alternating turns (6 deals of 3 cards each per round).
## Formal rules
R1. Setup: A standard 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)` matches `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 added to `Table`.
R4. Chkouba Trigger: If a capture results in `Table == empty` AND it is not the final card of the 40-card deck, the capturing player earns `+1 Chkouba point`.
R5. Redeal & Round End:
- When hands are empty, if deck has cards, deal 3 cards to each player.
- When all 40 cards are played, remaining table cards are awarded to the player who made the last capture.
R6. End-of-Round Point Scoring:
- `MostCards`: 1 point if `count(WonCards) > 20`. (0 points if tied 20-20).
- `MostCoins`: 1 point if `count(Coins) > 5`. (0 points if tied 5-5).
- `SevenOfCoins`: 1 point to owner of `(Coins, 7)`.
- `Primiera`: 1 point to player with highest Primiera score (using 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 in the same round with equal scores, another round is 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: Strictly bounded by 40 cards per round and finite hand deals.
- Simultaneous claims on the same resource or position: Strict sequential turn ordering.
- Player elimination mid-round; turn order repair: Not applicable; 2-player format.
- Resource exhaustion: Exactly 40 cards exhausted per round.
- Termination guarantee: Enforced by the finite card deck and strictly positive point accumulation.
## State representation
- Persistent state: `match_scores = [int, int]`, `round_num: int`.
- Round state: `deck: List[Card]`, `table: List[Card]`, `hands: Array[2][List[Card]]`, `captured: Array[2][List[Card]]`, `chkouba_points = [int, int]`, `last_captor: Optional[int]`.
- Observability: Imperfect information; `Table` and count of captured cards are public; opponent's hand is private; undealt deck order is hidden.
## Action space
- `play_card(card_index, chosen_subset_capture)`.
## Playability notes
- Single-player-vs-AI: Engine-ready; excellent candidate for Information Set MCTS (IS-MCTS) or counterfactual regret minimization (CFR).
- Group games (n>4): Standard 4-player partnership extension (2v2).
- Physical-skill games: Pure imperfect-information card strategy.
- What is lost: The theatrical café ambiance of slapping cards face down on a zinc counter.
## Implementation hints
Discrete card state machine. First milestone: implement subset-sum solver for table capture options and exact Primiera scoring evaluation.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Algerian Fishing Card Game (Algeria). (n.d.). Games of Countries. https://gamesofcountries.com/games/dz-algeria/chkouba-algeria
@misc{gamesofcountries-dz-algeria-chkouba-algeria,
title = {Algerian Fishing Card Game (Algeria)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/dz-algeria/chkouba-algeria}
}