Skip to main content
Formal Specification

Czech Marble Flicking — Formal Specification

Czechia · dexterity-small · Confidence: high

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Cvrnkání kuliček — AI-optimized specification ## General idea A turn-based 2D geometric precision contest where two agents maneuver 10 marbles across a continuous ground surface into a single target hole. The strategic tension centers on balancing direct pocketing attempts against tactical deflection shots that scatter opponent marbles away from the target zone. ## Formal model - **Abstraction taken:** The continuous physics of 2D marble rolling, friction, and elastic collisions on uneven soil is abstracted to a 2D vector physics model with impulse noise W∼𝒩(0,σ2) representing finger execution error. - **Player/agent count:** 2 agents (A0,A1). - **Turn model:** Strictly alternating sequential single actions after the opening toss phase. ## Formal rules R1. Setup: Board is a 2D plane with origin (0,0) at the center of a circular pocket of radius Rhole=0.05 m. Pitch boundary is [−5,5]×[−1,9] m. The throw line is at y=7.5 m. R2. Opening toss: Both agents sample an initial toss towards (0,0). The agent whose marble comes closer to (0,0) receives priority choice of turn order. R3. Throwing phase: Starting agent spawns 10 marbles along trajectories from y=7.5. Second agent spawns 10 marbles. Any marble landing with center inside radius Rhole is marked `POCKETED` immediately. R4. Active flick: On turn t, active agent i chooses one unpocketed marble m∈Mi and applies an impulse vector v→=(vx,vy) subject to ‖v→‖≤vmax. R5. Collision & Pocketing: - Kinematic propagation resolves all elastic sphere-sphere collisions between marbles. - If marble center enters Rhole with velocity ‖v→‖<vcapture, its state changes to `POCKETED` and it is removed from the active plane. - If a marble leaves the pitch boundaries, it is repositioned at the nearest boundary perimeter point. R6. Turn alternation: Exactly one flick action per turn. Turn passes to opponent 1−i regardless of shot success. R7. Win condition: The frame ends immediately when all 10 marbles of agent i are `POCKETED`. Agent i is declared winner of the frame. R8. [gap-fill] Match termination / Move cap: If neither agent has pocketed all marbles after 100 total flicking turns, the agent with the strictly greater count of pocketed marbles wins the frame. If pocket counts are equal, the agent whose unpocketed marble is closest to the hole wins. ## Edge cases - Tie at the end condition: Resolved via R8 (count of pocketed marbles, then distance of nearest unpocketed marble to hole center). - A player with no legal move: Not applicable until all marbles are pocketed, at which point R7 triggers immediate victory. - Repetition / cycles: Bounded by R8 100-turn limit. - Simultaneous claims on the same resource or position: Handled by elastic hard-sphere collision resolution; marbles cannot occupy the same coordinate. - Player elimination mid-round: 2-player game; forfeiture or disconnection awards victory to the remaining agent. - Resource exhaustion: Marbles are finite (10 per agent) and monotonically decrease as they enter the hole. - Termination guarantee: Guaranteed by monotonic marble reduction and bounded by R8 turn limit. ## State representation - Persistent state: - `positions: dict[int, list[tuple[float, float]]]`: 2D coordinates for remaining active marbles of agent 0 and agent 1. - `pocketed_count: [int, int]`: Count of pocketed marbles per agent ∈[0,10]. - `turn_count: int`: Running counter of completed flicks. - `active_agent: {0, 1}`. - Per-turn ephemeral state: Vector impulse v→ applied to selected marble index. - Observable information: Fully observable (perfect information). ## Action space - `flick_marble(marble_index: int, angle: float, velocity: float)` - Preconditions: marble_index∈Mactive_agent, velocity∈(0,vmax], angle∈[−π,π). ## Playability notes - Single-player-vs-AI: Natural; 1 human vs. 1 AI agent on standard 2D vector field. - Group games (n>4): Codified as 1v1; multi-player extension functions via standard round-robin or knockout brackets. - Physical-skill games: Motor dexterity modeled as stochastic dispersion angle Δθ∼𝒩(0,σθ2) and velocity noise Δv∼𝒩(0,σv2). - What is lost: Tactile ground texture evaluation and fine finger calibration are replaced by abstract parameter selection. ## Implementation hints Low complexity. Use a basic 2D circular particle physics step with friction decay (μ≈0.2). The decision space is continuous but can be discretized to direct-shot candidate angles vs. defensive block shots. First milestone: single marble flick into static hole, then 20-marble collision loop.

Download as JSON

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

Download JSON
Cite this page

Czech Marble Flicking (Czechia). (n.d.). Games of Countries. https://gamesofcountries.com/games/cz-czechia/kulicky

@misc{gamesofcountries-cz-czechia-kulicky,
  title = {Czech Marble Flicking (Czechia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/cz-czechia/kulicky}
}