Formal Specification
Easter Egg Tapping and Rolling — Formal Specification
Croatia · festival-ritual · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Tucanje i koturanje pisanica — AI-optimized specification
## General idea
A two-agent ritual duel where agents pit hard-boiled egg tokens of varying shell hardness against each other in sequential tip-to-tip and base-to-base impact strikes. Shell integrity thresholds and strike mechanics determine which egg fractures, transferring ownership of the captured token to the surviving victor.
## Formal model
- **Abstraction taken:** Eggshell calcium density and internal curvature are modeled as a shell integrity scalar . Each egg possesses two strike zones: Tip (*špica*) and Bottom (*guz*), each tracking intact/cracked status.
- **Player/agent count:** 2 agents () each holding an inventory of egg tokens.
- **Turn model:** Strictly sequential impact strike duels.
## Formal rules
R1. Setup:
- Agents select 1 egg each from inventory.
- Each egg has shell hardness and status .
R2. Phase 1 — Tip Duel (*Špica o špicu*):
- Agent holds egg stationary (defender); Agent executes action `tap_strike(force: float, angle: float)`.
- Impact force .
- Damage applied: ; .
- Fracture evaluation:
- If and : Egg 1 tip cracks (); wins Phase 1.
- If and : Egg 2 tip cracks (); wins Phase 1.
- [gap-fill] If both or neither crack, strike repeats with force increment.
R3. Phase 2 — Base Duel (*Guz o guz*):
- The winner of Phase 1 strikes the bottom of the opposing egg using their uncracked base.
- Same damage and fracture evaluation applies to `base_intact`.
R4. Egg Capture and Token Transfer:
- An egg with both tip and base cracked is CAPTURED by the surviving agent: .
R5. Tournament Match Victory:
- Match continues across rounds until an agent exhausts all eggs in inventory.
- [gap-fill] The agent holding the most captured eggs at tournament end is declared the Champion.
## Edge cases
- Tie at the end condition: Tied remaining egg counts broken by total captured broken egg tokens.
- A player with no legal move: An agent with eggs remaining must select an egg for the duel.
- Repetition / cycles: Bounded by strictly increasing force increments per strike and strictly decreasing egg inventories.
- Simultaneous claims on the same resource or position: Strikes occur in strict sequential order.
- Player elimination mid-round; turn order repair: An agent who runs out of eggs is eliminated from subsequent rounds.
- Resource exhaustion: Egg inventory strictly depletes as eggs are captured.
- Termination guarantee: Strictly positive fracture probability with increasing force guarantees duel termination in finite strikes.
## State representation
- Persistent state: `agent_inventories: dict[int, list[Egg]]`, `captured_eggs: dict[int, list[Egg]]`, `duel_index: int`.
- Ephemeral round state: `active_egg_1: Egg`, `active_egg_2: Egg`, `current_phase: enum[TIP, BASE]`, `strike_force: float`.
- Observable information: Private shell hardness ; strike outcomes and visible crack status are public.
## Action space
- `select_egg(inventory_idx: int)`: Egg selection action.
- `tap_strike(force: float, angle_offset: float)`: Strike execution parameters.
## Playability notes
- Single-player-vs-AI: Natural; player inspects and selects eggs based on estimated hardness and aims strikes to minimize self-damage.
- Group games (n>4): Solved via single-elimination tournament bracket.
- Physical-skill games: Shell fracture mechanics modeled via kinetic energy thresholds and normal damage distributions.
- What is lost: Visual delight of wax-batik painted motifs, taste of eating hard-boiled eggs with spring onions.
## Implementation hints
Discrete state machine with continuous fracture threshold calculations. First milestone: implement 1v1 tip-and-base duel with deterministic hardness before adding multi-egg tournament brackets.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Easter Egg Tapping and Rolling (Croatia). (n.d.). Games of Countries. https://gamesofcountries.com/games/hr-croatia/tucanje-pisanica
@misc{gamesofcountries-hr-croatia-tucanje-pisanica,
title = {Easter Egg Tapping and Rolling (Croatia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/hr-croatia/tucanje-pisanica}
}