Formal Specification
Slovak Earthen Marble Flicking — Formal Specification
Slovakia · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 4
# Cvrnkanie guličiek do jamky — AI-optimized specification
## General idea
A turn-based 2D spatial dexterity game where agents manage a pool of 10 colored marbles on a planar surface around a central circular target basin (). Agents choose which marble to flick, setting aim angle and impulse force to sink their own marbles while strategically colliding with opponent marbles to disrupt their approaches.
## Formal model
- **Abstraction taken:** Marble trajectories are resolved via a 2D planar physics model with Coulomb surface friction () and elastic sphere-to-sphere collisions (). An agent's chosen impulse vector is subject to execution noise scaled by marble-to-pit distance.
- **Player/agent count:** 2 to 6 agents.
- **Turn model:** Sequential turns. Sinking a marble grants +1 immediate bonus action [gap-fill].
## Formal rules
R1. Setup: Central pit is located at origin with radius . Initial throw from : each agent's 10 marbles land with coordinates . Marbles landing with are immediately scored and banked.
R2. Active turn: The active agent chooses one of their un-banked marbles and specifies an impulse vector where .
R3. Physics simulation tick:
- Marble velocities and positions integrate until all marbles come to rest ().
- Elastic collisions between marbles resolve dynamically.
R4. Banking check: Any marble coming to rest inside the pit radius () is removed from the field and added to the owner's `banked_count`.
R5. Bonus action: If the active agent banked at least one of their own marbles on the current flick, they retain the turn and may execute another flick [gap-fill]. Otherwise, turn passes to the next player in rotation.
R6. Win condition: The first agent to achieve `banked_count == 10` immediately wins the game.
R7. Turn cap: If no agent reaches 10 banked marbles after 50 global rounds, the agent with the highest banked count wins [gap-fill].
## Edge cases
- Tie at the end condition: If multiple agents have equal banked counts at round 50, a sudden-death single-marble flick from 2 meters decides the winner [gap-fill].
- A player with no legal move: If an agent has 0 un-banked marbles remaining, they have already reached 10 and won.
- Repetition / cycles: Bounded by the 50-round global cap and monotonic consumption of un-banked marbles.
- Simultaneous claims on the same resource or position: Marbles occupy distinct continuous coordinates in ; physical collisions prevent spatial overlap.
- Player elimination mid-round; turn order repair: An agent who reaches 10 marbles immediately wins, ending the game; no mid-round elimination bypass required.
- Resource exhaustion (pieces, tokens, space, time): Marbles are conserved (10 per player); field boundary radius is bounded to (out of bounds reset to perimeter).
- Termination guarantee: 50-round cap guarantees finite termination.
## State representation
- Persistent state: `round: int`, `active_player_idx: int`, `player_marble_positions: dict[int, list[tuple[float, float]]]`, `banked_counts: dict[int, int]`.
- Per-flick ephemeral state: `chosen_marble_idx: int`, `impulse_magnitude: float`, `impulse_angle: float`, `bonus_earned: bool`.
- Observable information: Fully observable — all 2D coordinates of all marbles on the table and current scores are common knowledge.
## Action space
- `flick_marble(marble_index: int, impulse_force: float, angle_rad: float)`: Submit marble index, impulse magnitude , and angle .
## Playability notes
- Single-player-vs-AI: Excellent tactical simulation; human selects shot trajectories, bank angles, and carom opportunities against AI agents evaluating expected value.
- Group games (n>4): Scales naturally from 2 to 6 players; crowding near the pit increases tactical value of defensive deflection shots.
- Physical-skill games: Finger dexterity and surface friction are modeled via 2D physics integration with Gaussian execution noise.
- What is lost in the adaptation: Tactile feel of the clay/glass marble between the fingers, dirt terrain micro-ridges, and manual pit excavation.
## Implementation hints
Low-to-medium complexity. A basic 2D rigid-body disc physics engine (or Euler integration with circle-circle impulse formulas) handles all mechanics. First milestone: implement 2 marbles in 1v1 taking turns aiming at the center hole with simple friction deceleration.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Slovak Earthen Marble Flicking (Slovakia). (n.d.). Games of Countries. https://gamesofcountries.com/games/sk-slovakia/gulicky
@misc{gamesofcountries-sk-slovakia-gulicky,
title = {Slovak Earthen Marble Flicking (Slovakia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/sk-slovakia/gulicky}
}