Skip to main content
Formal Specification

Competitive Karuta / Poem-Snatching Game — Formal Specification

Japan · card · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: directGap-fills: 3
# Kyogi Karuta — AI-optimized specification ## General idea A competitive two-player card sport based on the 100 classical poems of the *Ogura Hyakunin Isshu*. Players arrange 25 grabbing cards in their home territories (*jijin*); as a reciter chants poems in random sequence, players race to identify and sweep the matching lower-phrase card from the tatami. Snatching cards from the opponent's territory or forcing opponent faults enables sending cards across the line until one player's territory is completely cleared. ## Formal model - **Abstraction taken:** Auditory phoneme processing (distinguishing the decisive syllable / *kimari-ji*), spatial memory recall, and high-velocity physical sweeping strokes are discretized into an event-driven reaction-time model. Each agent's response latency is modeled as `t_reaction = t_kimariji + t_memory_retrieval + motor_speed + epsilon`. - **Player/agent count:** 2 competing players (Player 0 and Player 1) plus 1 automated poem recitation engine. - **Turn model:** Sequential poem recitations; simultaneous latency comparison and territory card-sending per poem. ## Formal rules R1. Setup and Card Allocation: - From the 100-card *Hyakunin Isshu* deck, 50 cards are chosen at random. The remaining 50 cards become unplayed "dead cards" (*kara-fuda*). - 25 cards are placed in Player 0's territory (*jijin_0*), and 25 cards are placed in Player 1's territory (*jijin_1*). R2. Recitation flow: - The reciter draws cards uniformly at random from the 100-poem pool without replacement. - Each poem recitation exposes phonetic syllables over time until its unique *kimari-ji* is reached. R3. Action submission: - Both agents simultaneously submit `strike(target_card_id, timestamp)`. R4. Successful Take Resolution: - The player with the lowest valid timestamp on the active matching card takes the card. - Own Territory Take: If taken from own *jijin*, the card is removed; that player's card count decreases by 1. - Opponent Territory Take: If taken from opponent's territory, the card is removed, and the taking player selects 1 card from their own *jijin* and sends it to the opponent (*okuri-fuda*), decreasing own count by 1 and increasing opponent count by 1. R5. Faults (*Otetsuki*): - An *otetsuki* occurs if a player touches any card in the territory where the target card is NOT located, or touches any card on a dead-card recitation. - Penalty: The non-faulting opponent sends 1 card from their *jijin* to the faulted player's territory. - Double Penalty: If Player A takes a card in Player B's territory and Player B commits an *otetsuki* in Player A's territory, Player A sends 2 cards to Player B. R6. Win condition: The match terminates the instant either player's *jijin* card count reaches exactly 0. That player is declared the winner. R7. [gap-fill] Exact latency tie resolution: If both players touch the target card with `|t_0 - t_1| < 1ms`, priority is awarded to the player defending their own home territory (*jijin priority*). R8. [gap-fill] Dead-card fault cooldown: When a dead card is read and both players fault simultaneously, neither player sends a card. R9. [gap-fill] Deck exhaustion termination: If all 100 poems are read without a territory reaching 0 cards, the player with fewer remaining cards in *jijin* wins the match. ## Edge cases - **Tie at the end condition:** Prevented by single-card clearance at match end; if resolved by R9, broken by lowest card count. - **A player with no legal move:** Players may always choose to pass/remain stationary during a poem recitation. - **Repetition / cycles:** Impossible; the 100-poem recitation deck strictly decreases without replacement. - **Simultaneous claims on the same resource or position:** Resolved by timestamp latency comparison (R4) or home-territory priority (R7). - **Player elimination mid-round:** Not applicable; strictly a 2-player match. - **Resource exhaustion:** 50 cards on board are strictly reduced towards 0. - **Termination guarantee:** Guaranteed by finite 100-poem recitation queue and strict net-card reduction upon successful takes. ## State representation - **Persistent state:** `jijin[2]` (sets of active card IDs in each player's territory), `recitation_deck` (queue of 100 poem IDs), `cards_in_play` (set of 50 active card IDs), `dead_cards` (set of 50 card IDs). - **Per-poem state:** `current_poem_id` (int), `is_dead_card` (bool), `kimariji_length` (int), `submitted_strikes[2]` (tuples of card ID and timestamp). - **Observable information:** Perfect spatial information of cards in both territories; hidden information: unread poem sequence in recitation deck. ## Action space - `strike_card(card_id: int, timestamp: float)`: Submit touch attempt on a specific card. - `send_card(card_id: int)`: Select card from own *jijin* to transfer to opponent after a winning take or opponent fault. - `hold()`: Refrain from striking during the current recitation. ## Playability notes - **Single-player-vs-AI:** Highly competitive; AI models human phonetic recognition latencies, spatial memory decay, and strategic card sending (e.g. sending 1-syllable cards to maintain home advantages). - **Group games (n>4):** Reduces to team match format (*Genpei-gassen*) where two teams manage shared territories. - **Physical-skill games:** Physical sweeping arm motion and tatami sliding are abstracted into response latency distributions. - **What is lost in the adaptation:** Physical finger sweeping collisions, tactical layout card rearrangement during pauses, and the resonant melodic voice of an authentic master reciter. ## Implementation hints Discrete card state system with event timestamps. Model the 100 poems with their exact *kimari-ji* syllable lengths (from 1 to 6 syllables). First milestone: implement 50-card allocation, recitation loop, take/send territory arithmetic, and Otetsuki penalty logic.

Download as JSON

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

Download JSON
Cite this page

Competitive Karuta / Poem-Snatching Game (Japan). (n.d.). Games of Countries. https://gamesofcountries.com/games/jp-japan/kyogi-karuta

@misc{gamesofcountries-jp-japan-kyogi-karuta,
  title = {Competitive Karuta / Poem-Snatching Game (Japan)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/jp-japan/kyogi-karuta}
}