Formal Specification
Easter Egg Rolling — Formal Specification
Lithuania · dexterity-throw · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 8
# Margučių ridenimas — AI-optimized specification
## General idea
Margučių ridenimas is a traditional Lithuanian Easter target and collection game played with decorated hard-boiled eggs (*margučiai*). Players take turns rolling eggs down an inclined wooden chute (*lovelis*) onto a flat playing surface populated by resting eggs from previous rolls. Striking any resting egg captures it into the player's personal collection and awards an immediate consecutive bonus roll; missing leaves the rolled egg on the field as an additional target for subsequent players.
## Formal model
- **Abstraction taken:** Probabilistic-proxy. Continuous egg geometry (ovoid wobble, shell irregularities), wooden chute incline physics, and rolling friction on cloth/wood/grass are modeled via a 2D trajectory generator with angle dispersion and deceleration: [gap-fill]. Target collisions are resolved via 2D circle-circle intersection tests.
- **Player/agent count:** agents () in sequential clockwise rotation.
- **Turn model:** Sequential turns with dynamic bonus chaining (an agent continues rolling as long as each roll produces at least one collision).
## Formal rules
R1. Setup and Inventory:
- Each agent starts with an initial inventory of eggs in their hand [gap-fill].
- Chute is fixed at origin facing the positive y-axis (, width ).
- Field target set is initialized by Player 1 releasing 1 egg down the chute without scoring capability, establishing the first target at [gap-fill]. Player 1's inventory becomes .
R2. Active Turn Mechanics:
- Active agent (with inventory ) selects launch aim angle and release height ratio along the chute [gap-fill].
- The egg travels down the chute, exiting at with velocity vector , subject to continuous deceleration and stochastic wobble noise:
where [gap-fill].
R3. Collision Detection:
- The rolling egg (radius ) traverses path .
- Collision test: For every resting target egg with center , a collision occurs if .
- Struck set: Let be the set of all eggs touched along the trajectory.
R4. Turn Resolution:
- Case A — Successful Hit ():
- Agent collects all struck eggs into their personal score bank ().
- Struck eggs are removed from the field: .
- The rolling egg used for the throw is also returned to Agent 's inventory ( remains unchanged).
- Bonus Roll: Agent immediately retains the turn and executes another roll.
- Case B — Miss ():
- The rolling egg comes to a halt at its terminal resting coordinate .
- The egg becomes a new permanent target in the field: .
- Agent 's inventory decreases by 1 ().
- Turn passes clockwise to the next agent in rotation with .
R5. Game Termination and Win Condition:
- The game ends when all agents have exhausted their active hand inventory () [gap-fill].
- Final Score: For each agent , .
- The agent holding the highest number of collected eggs wins the title "King of the Eggs" (*kiaušinių karalius*).
## Edge cases
- Tie at the end condition: If multiple players hold equal highest egg counts at termination, the tied players conduct a sudden-death single-egg roll against a single centered target peg [gap-fill].
- A player with no legal move: An agent with is skipped in the turn rotation.
- Repetition / cycles (and the loop-breaking rule): Inactive cycling is impossible; every miss strictly decrements the global inventory pool , guaranteeing a finite game horizon.
- Simultaneous claims on the same resource or position: Turns are strictly sequential; a rolling egg claims all eggs touched along its unique trajectory in time order.
- Player elimination mid-round; turn order repair: When an agent's inventory hits 0, they are bypassed in subsequent rotations; remaining agents continue in clockwise sequence.
- Resource exhaustion (pieces, tokens, space, time): The game terminates by definition when all player inventories reach 0; any uncollected eggs remaining in at termination remain unallocated or are swept into a common pot [gap-fill].
- Termination guarantee: Provably terminates because the total number of rolls resulting in misses is bounded by , and consecutive hit streaks must eventually terminate as field targets are depleted.
## State representation
- Persistent state: Agent count , hand inventories , bank scores , turn rotation index .
- Per-turn ephemeral state: Field target set , active rolling egg trajectory , collision set , terminal position .
- Observable information: Fully observable — all egg positions on the floor, player inventories, and score banks are public.
## Action space
- `roll_egg(aim_angle, release_height)`: Choose chute angle and release height .
## Playability notes
- Single-player-vs-AI: Completely natural — player aims trajectory against resting field eggs, competing against AI agents with varying aim precision.
- Group games (n>4): Plays excellently with 4–10 players; turn dynamics create high tension as missed eggs accumulate, making subsequent turns richer in targets.
- Physical-skill games: The physical wobble of asymmetric hard-boiled eggs and chute aiming are modeled as stochastic trajectory dispersion around the chosen angle.
- What is lost: The visual beauty of onion-skin and hot-wax dyed egg patterns (*raštai*), the crisp sound of eggshells clinking, and the joy of eating cracked eggs on Easter morning are abstracted into numerical collection counters.
## Implementation hints
Requires a 2D continuous canvas for field egg coordinates and line/circle ray-casting for collision detection.
First milestone: Build the trajectory generator and collision resolver for 1 roller against a static field of 3 eggs, testing bonus chaining logic.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Easter Egg Rolling (Lithuania). (n.d.). Games of Countries. https://gamesofcountries.com/games/lt-lithuania/marguciu-ridenimas
@misc{gamesofcountries-lt-lithuania-marguciu-ridenimas,
title = {Easter Egg Rolling (Lithuania)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/lt-lithuania/marguciu-ridenimas}
}