Formal Specification
Egg Rolling — Formal Specification
Latvia · dexterity-throw · Confidence: low
← Back to game pageImplementation 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 and release height/velocity ); 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 ().
- **Turn model:** Strictly sequential, cyclic turn order with immediate bonus turns on successful hits.
## Formal rules
R1. **Setup:** Chute base is fixed at origin , aiming toward the positive half-plane . Landing field is an open 2D plane [gap-fill]. Each agent starts with an initial inventory of eggs in their personal basket [gap-fill].
R2. **Turn sequence:** Players take turns in cyclic order ().
R3. **Roll action and trajectory sampling:**
- The active player chooses launch angle and release speed m/s [gap-fill].
- Trajectory is generated with directional drift and lateral wobble: [gap-fill].
- The egg travels along the path until decelerating to zero velocity at .
R4. **Collision and capture resolution:**
- If the rolling path comes within collision distance cm of any stationary egg 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 , 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 ( 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 () 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 , stationary egg coordinates on the field , 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 and speed . Precondition: active turn holder, egg inventory .
## 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 (); 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 JSONCite 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}
}