Formal Specification
Joseon Paper Card Gambling / Ten-Sum Point Showdown — Formal Specification
South Korea · card · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: directGap-fills: 1
# Tujeon — AI-optimized specification
## General idea
An incomplete-information card game where agents are dealt 5 cards from a 40-card multiset. Agents must solve a subset-sum combinatorial problem to find three cards summing to a multiple of 10 (), ranking the remaining two cards via a pair hierarchy (*Ttaeng*) or modulo-10 unit sum (*Gkeut*).
## Formal model
- **Abstraction taken:** Direct discrete card deck modeling. Standard 40-card deck suits ( cards total, values ).
- **Player/agent count:** 2 to 8 agents ().
- **Turn model:** Simultaneous private hand card evaluation followed by simultaneous public showdown.
## Formal rules
R1. **Deck Initialization & Dealing:**
- Standard multiset contains 4 copies of each integer .
- Pot is initialized with ante chip per active agent: .
- Dealer shuffles uniformly at random and deals 5 private cards to each agent .
R2. **Subset Sum Evaluation (Jitgi / 짓기):**
- Each agent searches for a 3-card subset such that:
- If no such 3-card subset exists: Hand is invalid (`JitgiFailed`). Hand score (disqualified from pot).
R3. **Showdown Hand Ranking (Jokbo):**
- If valid 3-card subsets exist, the agent selects the subset that maximizes the value of the remaining two cards .
- **Tier 1 (Ttaeng / Pairs):** If :
(e.g., , ).
- **Tier 2 (Gkeut / Modulo Sums):** If :
(e.g., sum remainder ).
R4. **Showdown Resolution & Pot Distribution:**
- All agents reveal hands simultaneously.
- Highest rank value .
- Winning set .
- If : Single winner takes entire pot .
- If : Tie! Pot carries over to next deal.
- If (all agents failed Jitgi): Pot carries over.
R5. [gap-fill] Pot Carryover Limit:** If pot carries over for 3 consecutive rounds, a sudden-death high-card single-draw breaks the deadlock.
## Edge cases
- Tie at the end condition: Handled by R4 and R5 via pot carryover and high-card sudden-death break.
- A player with no legal move: Combinatorial subset selection is deterministic over finite 10-subset search .
- Repetition / cycles: Bounded; rounds are independent identically distributed deals, and pot carryover limit enforces termination.
- Simultaneous claims on the same resource or position: Simultaneous showdown resolves through total order .
- Player elimination mid-round; turn order repair: Chips below ante () eliminates agent from next deal.
- Resource exhaustion (pieces, tokens, space, time): Deck contains 40 cards; max 8 players consume cards (exact exhaustion bound).
- Termination guarantee: Enforced by finite chip pools and hard round caps.
## State representation
- **Persistent state:** Number of players , chip stacks , current pot , consecutive tie counter.
- **Per-round ephemeral state:** Deck array , private hands , calculated ranks , showdown reveal flags.
- **Observable information:** Imperfect information: each agent observes only private hand and public pot size . At showdown, all hands are revealed.
## Action space
- `commit_hand(c_a, c_b, c_c)`: Select 3 cards to form the multiple of 10 base. Precondition: .
## Playability notes
- Single-player-vs-AI: Fast, addictive poker-style card showdown game; human evaluates hand combinations against AI players.
- Group games (n>4): Natively designed for 2 to 8 players around a betting table.
- Physical-skill games: Not applicable; pure discrete card combinatorics.
- What is lost in the adaptation: The tactile sliding of long, narrow oiled paper slips (*yeot-bangmangi*) between thumb and palms to reveal card pips millimeter by millimeter.
## Implementation hints
Extremely low complexity. The hand evaluation requires checking all subsets of 5 integers, which takes microsecond in Python or C. First milestone: implement deck dealing and write a 10-line function to compute the optimal for any 5-card hand.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Tujeon (South Korea). (n.d.). Games of Countries. https://gamesofcountries.com/games/kr-south-korea/tujeon
@misc{gamesofcountries-kr-south-korea-tujeon,
title = {Tujeon (South Korea)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/kr-south-korea/tujeon}
}