Formal Specification
Czech Marble Flicking — Formal Specification
Czechia · dexterity-small · Confidence: high
← Back to game pageImplementation 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 representing finger execution error.
- **Player/agent count:** 2 agents ().
- **Turn model:** Strictly alternating sequential single actions after the opening toss phase.
## Formal rules
R1. Setup: Board is a 2D plane with origin at the center of a circular pocket of radius m. Pitch boundary is m. The throw line is at m.
R2. Opening toss: Both agents sample an initial toss towards . The agent whose marble comes closer to receives priority choice of turn order.
R3. Throwing phase: Starting agent spawns 10 marbles along trajectories from . Second agent spawns 10 marbles. Any marble landing with center inside radius is marked `POCKETED` immediately.
R4. Active flick: On turn , active agent chooses one unpocketed marble and applies an impulse vector subject to .
R5. Collision & Pocketing:
- Kinematic propagation resolves all elastic sphere-sphere collisions between marbles.
- If marble center enters with velocity , 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 regardless of shot success.
R7. Win condition: The frame ends immediately when all 10 marbles of agent are `POCKETED`. Agent 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 .
- `turn_count: int`: Running counter of completed flicks.
- `active_agent: {0, 1}`.
- Per-turn ephemeral state: Vector impulse applied to selected marble index.
- Observable information: Fully observable (perfect information).
## Action space
- `flick_marble(marble_index: int, angle: float, velocity: float)`
- Preconditions: , , .
## 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 and velocity noise .
- 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 (). 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 JSONCite 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}
}