Formal Specification
Card Slapping / Flipping Cards — Formal Specification
Japan · dexterity-throw · Confidence: low
← Back to game pageImplementation 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 JSONCite 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}
}