Formal Specification
Marbles (Hole and Triangle) — Formal Specification
Serbia · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Klikeri — AI-optimized specification
## General idea
A turn-based 2D precision positioning and elimination marble game. Agents compete on a continuous 2D surface containing a target hole (*roša*). Agents must first sink their marble into the hole to acquire "active hunter" status, after which they can target and eliminate opponents' marbles with direct shots, earning bonus consecutive turns on successful hits.
## Formal model
- **Abstraction taken:** The 5×5m dirt surface is modeled as a 2D continuous plane with friction. Hole located at with radius . Physical flick force and angle are parameterized into a 2D velocity vector with Gaussian aiming noise.
- **Player/agent count:** agents (, default ).
- **Turn model:** Sequential turn rotation with priority queue determined by initial lag. A successful hit or hole entry awards an immediate bonus turn.
## Formal rules
R1. Setup & Lag Phase:
- Baseline at . Each agent chooses lag force aimed at .
- Marbles come to rest at initial positions . Distance to hole .
- Priority queue sorted by ascending . Active status initialized `active[i] = False` for all . If a marble landed in hole (), `active[i] = True`.
R2. Turn Structure: Active agent from takes a shot:
- Agent selects aiming angle and shot power .
- Trajectory simulation: Marble rolls from current .
- **Hole Entry:** If marble trajectory terminates inside hole radius ():
- `active[i] = True`.
- Marble is placed at ready to shoot out.
- Agent receives an immediate bonus turn.
- **Collision with Opponent:** If trajectory intersects an opponent's marble ():
- Collision is resolved with elastic physics.
- If `active[i] == True`: Opponent is marked `eliminated = True` and removed from . Agent receives an immediate bonus turn.
- If `active[i] == False`: No elimination occurs; collision modifies both marble positions; turn passes to next agent in .
- **Miss:** If no collision or hole entry occurs, marble rests at new . Turn passes to next player in .
R3. Win Condition: When only 1 agent remains in , that agent is declared the winner of the round.
R4. [gap-fill] Turn Timeout: If a round exceeds total turns without resolving to a single survivor, the active agent with more eliminated opponents (or closest to hole) wins.
## Edge cases
- Tie at the end condition: Ties under R4 cap resolved by sudden-death direct shoot-off against a static target marble.
- A player with no legal move: Not applicable; an active agent can always choose an angle and force.
- Repetition / cycles: Bounded by R4's 50-turn cap and monotonic elimination of players.
- Simultaneous claims on the same resource or position: The hole at holds the active shooter; if an opponent rolls in, displacement physics resolve final positions.
- Player elimination mid-round / turn order repair: [gap-fill] Eliminated agents are cleanly popped from the priority rotation queue ; remaining queue indices decrement smoothly.
- Resource exhaustion: Number of marbles is fixed ().
- Termination guarantee: Guaranteed by monotonic elimination () and R4 turn cap.
## State representation
- Persistent state: `scores: dict[AgentID, int]`, `round_number: int`.
- Per-round state: `marble_positions: dict[AgentID, tuple[float, float]]`, `is_active: dict[AgentID, bool]`, `is_eliminated: dict[AgentID, bool]`, `turn_queue: list[AgentID]`, `active_index: int`.
- Observable information: Fully observable 2D state for all agents.
## Action space
- `shoot(angle_rad: float, power: float)`:
- `angle_rad`: Float .
- `power`: Float .
## Playability notes
- Single-player-vs-AI: Highly engaging; human player calculates geometric bank angles and risk-reward of hunting opponents vs retreating to the hole.
- Group games (n>4): Operates smoothly as a multi-agent survival battle-royale.
- Physical-skill games: Thumb flick muscle memory mapped to continuous vector math and Gaussian shot variance.
- What is lost in the adaptation: The tactile sensation of spinning glass marbles and reading real micro-contours of dirt and tree roots are replaced by idealized physics.
## Implementation hints
Standard 2D continuous physics model with friction. First milestone: implement ray-circle intersection for 2 marbles and hole radius check, then layer turn queue and bonus shot logic.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Marbles (Hole and Triangle) (Serbia). (n.d.). Games of Countries. https://gamesofcountries.com/games/rs-serbia/klikeri
@misc{gamesofcountries-rs-serbia-klikeri,
title = {Marbles (Hole and Triangle) (Serbia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/rs-serbia/klikeri}
}