Skip to main content
Formal Specification

Passover Walnuts - The Pit — Formal Specification

Israel · dexterity-throw · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 3
# Egozim - Guma — AI-optimized specification ## General idea Egozim - Guma is a turn-based, stake-driven dexterity game played with physical projectiles (walnuts) on a 2D surface featuring a central target sink (the Guma pit). Agents decide whether to target the high-reward but difficult pit or strike existing loose walnuts to chip away at the opponent's pool. It is an economy-management game where mechanical throws are abstracted as risky investments. ## Formal model - **Abstraction taken:** The 2D dirt floor is modeled as a Cartesian grid [−W,W]×[−H,H] with W=H=3 meters. The Guma is a circular target at origin (0,0) with radius Rguma=0.05 meters. A roll is a stochastic vector from starting position (0,−2.5) toward a chosen target. - **Player/agent count:** 2 to 8 players. - **Turn model:** Sequential round-robin rotation. ## Formal rules R1. **Setup:** Each agent starts with a bag of Nstart=15 walnuts. R2. **The Ante:** At the start of a round, every active agent must transfer exactly 1 walnut from their bag to the `guma_pot` (initially positioned at (0,0)). R3. **The Roll Action:** On their turn, the active agent selects a target coordinate (xtar,ytarget). They expend exactly 1 walnut from their bag to execute `roll_walnut(target_x, target_y)`. - The resting position of the walnut is computed: p→final=(xtar+ϵx,ytar+ϵy) [gap-fill] where ϵ∼𝒩(0,σ2), and σ2 is proportional to the distance of the roll and inversely proportional to the agent's accuracy skill. R4. **Resolving Outcomes:** - **Mora/Guma Entry:** If Distance(p→final,(0,0))≤Rguma, the walnut falls in. The active agent immediately claims all walnuts in `guma_pot` and adds them to their bag. The round ends, and a new round begins with an Ante (R2). - **Target Collision:** If Distance(p→final,p→other_walnut)≤Rcollision (0.04 meters), a collision occurs. The active agent claims the targeted opponent's walnut, removing it from the board. - **Miss:** If neither condition is met, the walnut remains stationary at p→final and is added to the set of loose targets. R5. **Elimination:** An agent whose walnut count reaches 0 is immediately eliminated from the game. R6. **Winning & Termination:** [gap-fill] The game terminates when either: only one agent remains with walnuts, or 10 complete rounds have been played. In the latter case, the agent with the highest walnut count in their bag is declared the winner. ## Edge cases - **Tie at the end condition:** If two players have equal walnuts at round 10, the player who won the most direct Guma entries wins the tiebreaker. - **A player with no legal move:** Not applicable; rolling a walnut is always legal as long as the player has at least 1 walnut. - **Repetition / cycles:** If players repeatedly miss, the board fills up with target walnuts, which mathematically increases the probability of a collision, guaranteeing eventual round resolution. - **Simultaneous claims on the same resource:** Not applicable; turns are sequential. - **Player elimination mid-round:** The player is skipped in subsequent rotations; any walnuts they left on the field remain on the board as loose targets. - **Resource exhaustion:** If the collective pool of walnuts runs out, the game ends immediately. - **Termination guarantee:** Guaranteed by R6 (10-round cap) and R5 (zero-walnut elimination). ## State representation - **Persistent state:** - `agent_walnuts`: Map of `agent_id` to integer. - `guma_pot`: Integer counting walnuts currently inside the pit. - `board_walnuts`: List of 2D coordinates representing stationary walnuts currently on the field. - `active_agent_index`: Integer. - **Per-turn ephemeral state:** - `roll_outcome`: Coordinate (x,y). ## Action space - `roll_walnut(target_x, target_y)`: Roll a walnut from the starting line. Precondition: agent has at least 1 walnut and it is their turn. ## Playability notes - **Single-player-vs-AI:** Highly playable. The user selects a target coordinates and power level. AI agents utilize basic utility maximization: if the pot is large, they aim at the Guma; if the pot is empty but opponents' walnuts are clustered, they aim for a collision strike. - **Group games (n>4):** Scales cleanly without structural changes. - **Physical-skill games:** [gap-fill] Walnut rolls are simulated using a standard normal deviation model where the variance is parameterized by surface friction and thrower skill. - **What is lost in the adaptation:** The unevenness of real dirt, the texture and weight differences of individual walnuts, and the tactile joy of carrying a bulging cloth sack of won walnuts are lost. ## Implementation hints - Model the 2D coordinate board state and collision logic. - Implement the round-based state machine, ensuring the pot is correctly swept on a Guma entry and antes are deducted. - Write a simple AI opponent that evaluates the expected value of throwing at the Guma versus hitting a close opponent marble.

Download as JSON

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

Download JSON
Cite this page

Passover Walnuts - The Pit (Israel). (n.d.). Games of Countries. https://gamesofcountries.com/games/il-israel/egozim-guma

@misc{gamesofcountries-il-israel-egozim-guma,
  title = {Passover Walnuts - The Pit (Israel)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/il-israel/egozim-guma}
}