Skip to main content
Formal Specification

Card Slapping / Flipping Cards — Formal Specification

Japan · dexterity-throw · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 3
# Menko — AI-optimized specification ## General idea A physical card-slapping and card-flipping game. Players take turns slamming thick illustrated pressed cardboard cards onto the ground to generate ground impact shockwaves and air pressure, attempting to flip an opponent's card face-over (*Okoshi*) or propel it outside a circular boundary (*Hataki*) to capture it. ## Formal model - **Abstraction taken:** Three-dimensional card aerodynamics, sudden air-cushion displacement, and ground surface rebound dynamics are abstracted into a discrete turn-based geometric contest. Strategic choice involves selecting throw coordinates and power output, with stochastic capture probabilities: `P(flip) = f(impact_distance, power, skill)`. - **Player/agent count:** 2 to 6 players (standard 1v1 match format). - **Turn model:** Sequential alternating turns. ## Formal rules R1. Arena setup: A circular flat boundary of radius `R = 1.0` meters on the ground plane. R2. Defender position: The defending card rests at coordinate `(x_def, y_def)` inside the arena with orientation state `orientation in {FACE_UP, FACE_DOWN}`. R3. Attacking turn: The active player commits a throw specifying target landing coordinates `(x_atk, y_atk)` and throw power `P in [0.5, 1.0]`. R4. Throw resolution: - Distance between impact and defender card: `d = hypot(x_atk - x_def, y_atk - y_def)`. - Flip probability: `P(flip) = clamp(P * (1.0 - d / 0.25) * player_skill, 0.0, 0.85)`. - Lateral displacement: `slide_distance = max(0.0, (P * 0.4) - (d * 1.2))`. R5. Capture conditions: - Flip Victory (*Okoshi*): If a flip roll succeeds, the defending card reverses its orientation, and the attacker captures the card. - Ring Knockout (*Hataki*): If `hypot(x_def_new, y_def_new) > R`, the defending card is blasted outside the ring and captured by the attacker. - Captured cards award 1 victory point to the attacker. R6. Missed throw: If the throw fails to flip or eject the card, the thrown card remains at `(x_atk, y_atk)` as an additional target, and the turn passes. R7. Match victory: The first player to capture 3 cards wins the match. R8. [gap-fill] Card inventory cap: Each player starts with a deck of 5 cards; if a player runs out of cards to place in the arena, they lose by card exhaustion. R9. [gap-fill] Wedge capture (*Saba-ori*): If the thrown card lands wedged under the defender's card (`d < 0.03m`), it triggers an automatic capture. R10. [gap-fill] Maximum match turns: If neither player achieves 3 captures within 20 turns, the player with more captured cards wins; if tied, a single sudden-death throw decides the winner. ## Edge cases - **Tie at the end condition:** Resolved by sudden-death throw (R10). - **A player with no legal move:** Active player always has a legal throw action while possessing cards. - **Repetition / cycles:** Missed throws leave cards on the ground, creating new targets; bounded by R10 (20-turn cap). - **Simultaneous claims on the same resource or position:** Turns are strictly sequential; capture is assigned exclusively to the active thrower. - **Player elimination mid-round:** In multiplayer (>2), players who lose all cards in their hand are eliminated from subsequent rounds. - **Resource exhaustion:** Bounded by each player's 5-card inventory (R8). - **Termination guarantee:** Guaranteed by non-zero capture probability on close throws and the 20-turn hard cap (R10). ## State representation - **Persistent state:** `scores[2]` (ints in `[0..3]`), `card_inventory[2]` (counts of remaining cards in hand), `turn_index` (int). - **Per-turn state:** `ground_cards` (list of cards on ground: `{id, owner, x, y, orientation}`), `active_player` (0 or 1). - **Observable information:** Fully observable perfect-information game. ## Action space - `throw_card(target_x: float, target_y: float, power: float)`: Slam a card from hand toward target ground coordinates. ## Playability notes - **Single-player-vs-AI:** Highly playable; AI evaluates optimal landing offsets balancing flip probability against the risk of leaving its own card vulnerable on a miss. - **Group games (n>4):** Scales cleanly to 3–6 player multiplayer free-for-all; cards left on the ground accumulate into a rich target field. - **Physical-skill games:** Physical wrist whipping speed and air-blast angle are abstracted into impact coordinates and power parameters. - **What is lost in the adaptation:** The physical tactile slam, card bending/waxing customizations, and the distinctive loud "pan!" acoustic snap. ## Implementation hints Discrete turn-based geometric simulator. 2D Euclidean distance and boundary checks. First milestone: implement 1v1 turn loop with flip and knockout distance formulas, then add multi-card ground accumulation.

Download as JSON

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

Download JSON
Cite this page

Card Slapping / Flipping Cards (Japan). (n.d.). Games of Countries. https://gamesofcountries.com/games/jp-japan/menko

@misc{gamesofcountries-jp-japan-menko,
  title = {Card Slapping / Flipping Cards (Japan)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/jp-japan/menko}
}