Formal Specification
Hong Kong Picture Card Slapping — Formal Specification
Hong Kong · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 4
# Gung Zai Zi — AI-optimized specification
## General idea
A turn-based card-slapping and capture game based on Hong Kong *Gung Zai Zi* (Picture Card Slapping). Players wager cardboard character cards into a central ground pot, taking turns choosing strategic striking techniques (cupped-palm air blast, direct contact strike, or aerial flick) to create aerodynamic pressure differentials that flip opponent cards face-up to capture them.
## Formal model
- **Abstraction taken:** Fluid dynamic air compression and card surface contact friction are abstracted into parameterized probabilistic flip functions conditioned on chosen technique, strike precision, and card orientation state.
- **Player/agent count:** 2 to 6 players taking sequential turns in cyclic order.
- **Turn model:** Sequential turns. Each turn, the active player chooses a striking technique and target coordinate within the ring.
## Formal rules
R1. **Setup & Pot Staging:** Each of the players stakes cards face-down in a central target circle of radius . Total pot cards. Each card has state .
R2. **Turn Action & Technique Selection:** On their turn, the active player selects one of three physical slap techniques:
- **Air-Blast Slap (`AIR_BLAST`, ):** Cupped palm slammed onto the surface adjacent to target cards. Evaluates independent flip probabilities for all cards within blast radius .
- **Direct Strike (`DIRECT_STRIKE`, target_card_id):** Slamming hand/card directly onto one specific target card. High single-card flip probability, with a small risk of committing a touch foul.
- **Card Flick (`FLICK_CARD`, angle, power):** Throwing a master card from 1 meter distance into the target cluster.
R3. **Capture Evaluation:**
- Any card that transitions from `FACE_DOWN` to `FACE_UP` is immediately claimed by the active player and removed from the arena pot ( card captured).
- If all remaining cards in the pot are flipped in a single action, the player achieves a *Clean Sweep* (*saang-tsing*) and receives bonus points.
R4. **Foul Execution:** If an agent commits a foul (`TOUCH_FOUL`), the turn ends immediately without captures, and the subsequent player receives a free focused strike.
R5. **Victory Condition:** The match concludes when all cards in the arena pot have been flipped and captured. The player with the highest total count of captured cards wins.
R6. [gap-fill] Pot geometry: cards distributed uniformly within circle of radius .
R7. [gap-fill] Probabilistic technique outcomes:
- `AIR_BLAST` at : For each card at distance , .
- `DIRECT_STRIKE`: on selected card; .
- `FLICK_CARD`: for primary target, for adjacent card.
R8. [gap-fill] Miss condition: If an action flips zero cards, the turn passes cleanly to the next player in cyclic order without penalty.
R9. [gap-fill] Loop-breaking round limit: If cards remain in the pot after 30 rounds ( turns), the match terminates; remaining un-flipped cards are discarded, and the winner is determined by current captured card totals.
## Edge cases
- **Tie at the end condition:** If multiple players capture an identical number of cards, a 1-round sudden-death playoff (1 stake card each, `DIRECT_STRIKE` duel) breaks the tie.
- **A player with no legal move:** As long as at least one `FACE_DOWN` card remains in the pot, all three slap techniques are legally available.
- **Repetition / cycles:** Repeated misses are strictly bounded by R9's 30-round hard cap.
- **Simultaneous claims on the same resource or position:** Turns are strictly sequential; physics evaluation is resolved atomically per player turn.
- **Player elimination mid-round:** Not applicable (all players remain active until pot exhaustion).
- **Resource exhaustion:** Board pot cards decrease monotonically as they are flipped and captured.
- **Termination guarantee:** Guaranteed by finite card count in pot and R9's 30-round terminal threshold.
## State representation
- **Persistent state:** `arena_radius: float = 0.3`, `initial_pot_size: int = 2 * N`.
- **Per-player state:**
- `captured_cards: int`
- `fouls_committed: int`
- **Per-turn ephemeral state:**
- `active_player: int`
- `cards_on_board: List[{id: int, pos: (float, float), state: str}]`
- `current_round: int`
- **Observable information:** Fully observable game state. All card positions, orientations (face-up/down), and player scores are public knowledge.
## Action space
- `slap_air_blast(x, y)`: Parameters: coordinates `x, y` within arena circle. Preconditions: active player, pot not empty.
- `slap_direct_strike(target_card_id)`: Parameters: `target_card_id` of an active `FACE_DOWN` card. Preconditions: active player.
- `flick_card(angle, power)`: Parameters: `angle in [0, 2*pi)`, `power in (0.0, 1.0]`. Preconditions: active player.
## Playability notes
- **Single-player-vs-AI:** Highly playable. AI evaluates expected value across action types based on spatial clustering of remaining face-down cards.
- **Group games (n>4):** Supports 2 to 6 players in round-robin order.
- **Physical-skill games:** Palm air-compression technique and angle precision are abstracted into parametric probability distributions.
- **What is lost in the adaptation:** Tactile sting of slapping cold concrete floors, card physical creasing, authentic cardboard scent, and playground trade bargaining.
## Implementation hints
- Model card positions as 2D coordinates with binary orientation state `is_flipped`.
- Action resolution is a simple stochastic roll per affected card.
- Branching factor: 1 choice of technique + discrete coordinate/target selection ( meaningful actions per turn).
- First milestone: 2-player simulation with 4 cards verifying flip probability calculations and capture tracking over 10 game runs.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Hong Kong Picture Card Slapping (Hong Kong). (n.d.). Games of Countries. https://gamesofcountries.com/games/hk-hong-kong/gung-zai-zi
@misc{gamesofcountries-hk-hong-kong-gung-zai-zi,
title = {Hong Kong Picture Card Slapping (Hong Kong)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/hk-hong-kong/gung-zai-zi}
}