Formal Specification
Hungarian Marbles (Golyóverés / Gödörbe gurítás) — Formal Specification
Hungary · dexterity-small · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 3
# Golyózás — AI-optimized specification
## General idea
A sequential turn-based precision flicking game on a 2D dirt plane where agents first navigate a shooter marble into a central pit to unlock offensive "Hunter" status, then execute line-of-sight striking shots against opponent marbles to eliminate them from the board.
## Formal model
- **Abstraction taken:** The continuous 2D surface is bounded in meters with the pit centered at origin with radius . Agent shot selection consists of an aim angle and target distance , resolved via a Gaussian error model parameterized by agent skill attribute .
- **Player/agent count:** 2 to 6 agents.
- **Turn model:** Strictly sequential rotation with consecutive bonus turns awarded on successful pit entry or opponent strike.
## Formal rules
R1. Setup:
- Pitch origin is . Throw line is at .
- Each agent has 1 shooter marble. Status , .
R2. Opening Toss: Each agent tosses from line toward . Landing coordinate [gap-fill].
- If , agent immediately gains .
R3. Turn Action: The active non-eliminated agent selects:
- If : `FLICK_TO_PIT(power, angle)` aiming at .
- If : `STRIKE_OPPONENT(target_agent_id)`.
R4. Shot Resolution:
- Actual displacement , where .
- New position .
- If : Agent sets , repositions marble to , and receives 1 additional consecutive turn.
- If targeting opponent : If the trajectory passes within distance of , marble is struck.
- Agent is marked .
- Agent receives 1 additional consecutive turn.
R5. Miss / Turn Handover: If a flick fails to enter the pit or hit a declared target, turn passes to the next non-eliminated agent in rotation.
R6. Win condition: The last surviving non-eliminated agent wins the round.
## Edge cases
- Tie at the end condition: Not applicable; eliminations are strictly sequential, leaving exactly one sole survivor.
- A player with no legal move: Not applicable; an active agent always has a valid aim angle toward the pit or opponents.
- Repetition / cycles: If 50 consecutive scoreless/non-eliminating turns occur, the hunter with closest distance to the nearest target wins [gap-fill].
- Simultaneous claims on the same resource or position: The pit at can hold multiple marbles simultaneously without collision displacement [gap-fill].
- Player elimination mid-round; turn order repair: Eliminated agents are skipped in future turn rotations without altering remaining player order.
- Resource exhaustion (pieces, tokens, space, time): Marbles are persistent; eliminated marbles are removed from play.
- Termination guarantee: Monotonic reduction of active agent count from to 1 guarantees termination.
## State representation
- Persistent state: `active_player: int`, `positions: dict[int, tuple[float, float]]`, `is_hunter: dict[int, bool]`, `eliminated: dict[int, bool]`, `consecutive_misses: int`.
- Per-turn ephemeral state: `selected_shot: tuple[float, float]`, `impact_events: list[str]`.
- Observable information: Fully observable. All marble positions, hunter statuses, and rotation sequences are public.
## Action space
- `flick(angle: float, power: float)`: Parameterized vector flick.
- `strike(target_id: int)`: Aimed strike at a specific opponent.
## Playability notes
- Single-player-vs-AI: Highly playable; AI bot evaluates risk-reward between taking distant hunting shots vs safely repositioning in the pit.
- Group games (n>4): Scales naturally from 2 to 6 players.
- Physical-skill games: Fine finger-flicking dexterity is modeled through the Gaussian error dispersion .
- What is lost in the adaptation: Soil texture variations, pebble deflection physics, and psychological pressure of "for keeps" betting.
## Implementation hints
Low complexity. 2D Euclidean point-to-segment distance calculations for ray-sphere collisions. First milestone: Implement 2-player pit entry and striking logic with deterministic accuracy before tuning noise parameters.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Hungarian Marbles (Golyóverés / Gödörbe gurítás) (Hungary). (n.d.). Games of Countries. https://gamesofcountries.com/games/hu-hungary/golyozas
@misc{gamesofcountries-hu-hungary-golyozas,
title = {Hungarian Marbles (Golyóverés / Gödörbe gurítás) (Hungary)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/hu-hungary/golyozas}
}