Skip to main content
Formal Specification

Egg Rolling — Formal Specification

Latvia · dexterity-throw · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 8
# Olu ripināšana — AI-optimized specification ## General idea A festive turn-based rolling and target capture game. Players roll dyed hard-boiled eggs down an inclined wooden chute into an open landing field; colliding with any stationary target egg captures that egg and earns an immediate bonus roll, while a missed roll leaves the egg resting on the field as an active target for opponents. ## Formal model - **Abstraction taken:** Physical egg rolling dynamics (asymmetric egg wobble, surface friction, and chute launch dynamics) are modeled as a 2D trajectory simulation with stochastic dispersion. The agent selects launch parameters (chute orientation angle θlaunch and release height/velocity v0); the trajectory is traced across a 2D landing plane, testing for geometric circle-circle intersections with stationary eggs. - **Player/agent count:** 2 to 15 agents (K≥2). - **Turn model:** Strictly sequential, cyclic turn order with immediate bonus turns on successful hits. ## Formal rules R1. **Setup:** Chute base is fixed at origin (0,0), aiming toward the positive half-plane y>0. Landing field is an open 2D plane [gap-fill]. Each agent starts with an initial inventory of Estart=5 eggs in their personal basket [gap-fill]. R2. **Turn sequence:** Players take turns in cyclic order (P1,P2,…,PK). R3. **Roll action and trajectory sampling:** - The active player chooses launch angle θ∈[−π/4,π/4] and release speed v0∈[1.0,5.0] m/s [gap-fill]. - Trajectory is generated with directional drift and lateral wobble: Δθ(t)∼𝒩(0,σ2) [gap-fill]. - The egg travels along the path until decelerating to zero velocity at (xend,yend). R4. **Collision and capture resolution:** - If the rolling path comes within collision distance dcoll≤2regg=8.0 cm of any stationary egg j resting on the field: - A hit is registered. - The active player retrieves the rolled egg and collects all struck target egg(s) into their personal scoring basket [gap-fill]. - The active player receives an immediate bonus roll (retaining the turn). R5. **Miss resolution:** - If the rolling egg comes to a stop without contacting any resting egg: - The egg remains stationary at (xend,yend), becoming a permanent target for future rolls. - The player's inventory decreases by 1, and the turn passes to the next player in rotation. R6. **Player out of eggs:** If an agent's turn arrives and their inventory is 0, they are skipped in turn rotation [gap-fill]. R7. **Game end and scoring:** - The game terminates when all active players have 0 remaining unrolled eggs, or when no stationary target eggs remain on the field [gap-fill]. - Total score per player equals the total number of captured eggs in their basket. The player with the highest total is declared the winner. ## Edge cases - Tie at the end condition: if two players tie on total captured eggs, the player with the highest single-turn capture count wins; if still equal, resolved as a shared win [gap-fill]. - A player with no legal move: if an agent has 0 eggs in hand, they have no legal roll and are skipped per R6. - Repetition / cycles: bounded by strictly finite initial egg inventory (K⋅Estart total eggs in the economy); every miss reduces total hand inventory by 1, guaranteeing finite termination. - Simultaneous claims on the same resource or position: not applicable — turns are sequential; collisions resolve along the rolling egg's trajectory in order of temporal contact. - Player elimination mid-round: an agent with 0 eggs is skipped in rotation; remaining players continue until total inventory is exhausted. - Resource exhaustion: initial hand inventories deplete monotonically on misses, terminating the game per R7. - Termination guarantee: guaranteed by the finite non-renewable supply of unrolled eggs (K⋅Estart) and strictly positive miss probability. ## State representation - Persistent state: player IDs, turn rotation list, cumulative captured egg count per player. - Per-turn ephemeral state: personal egg inventories (E1…EK), stationary egg coordinates on the field {(xj,yj)}, active turn player, bonus roll flag. - Observable information: full public observability — all egg inventories, field egg coordinates, scores, and chute orientations are public knowledge. ## Action space - `roll_egg(angle, speed)`: execute egg release from chute with chosen angle θ∈[−π/4,π/4] and speed v0∈[1.0,5.0]. Precondition: active turn holder, egg inventory >0. ## Playability notes - Single-player-vs-AI: natural — human vs 1 or more AI agents choosing risk-adjusted target vectors across the field. - Group games (n>4): natively scales to large family/community groups (2≤N≤15); reduction to 2 agents preserves 100% of the strategic dynamic (banking target eggs vs attempting tricky caroms). - Physical-skill games: egg shape irregularities and physical grass friction are abstracted into trajectory wobble variance and decelerating drag. - What is lost: physical beauty of handcrafted onion-dyed egg patterns, tactile eggshell warmth, and minor egg cracking upon collision. ## Implementation hints Low complexity. Simple 2D raymarching or swept-circle collision detection against static 2D points. First milestone: implement 2D trajectory generation with drag and wobble, circular hit detection against stationary target list, and inventory/turn state machine.

Download as JSON

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

Download JSON
Cite this page

Egg Rolling (Latvia). (n.d.). Games of Countries. https://gamesofcountries.com/games/lv-latvia/olu-ripinasana

@misc{gamesofcountries-lv-latvia-olu-ripinasana,
  title = {Egg Rolling (Latvia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/lv-latvia/olu-ripinasana}
}