Formal Specification
Passover Walnuts - The Ramp — Formal Specification
Israel · dexterity-throw · Confidence: low
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 3
# Egozim - Rampa — AI-optimized specification
## General idea
Egozim - Rampa is a turn-based physical game where agents release a spherical projectile (walnut) down an inclined plane (the Rampa) to roll across a flat floor and strike stationary target walnuts. Since gravity does the acceleration, the player's choice is restricted to the starting horizontal launch point on the ramp, which dictates the rollout angle. Strategy consists of targeting dense clusters to maximize hit probability.
## Formal model
- **Abstraction taken:** The ramp is a 1D line at . The floor is a 2D plane extending from the ramp base at . Releasing a walnut at starting launches it on a linear path with rollout angle (perpendicular to the ramp), plus a small stochastic deviation.
- **Player/agent count:** 2 to 6 players.
- **Turn model:** Sequential round-robin rotation.
## Formal rules
R1. **Setup:** Each agent starts with a bag of walnuts.
R2. **Target Setup:** At game start, every player places exactly 1 walnut on the floor at a designated target area: . These form the initial set of `floor_walnuts`.
R3. **The Slide Action:** On their turn, the active agent selects a launch coordinate . They expend exactly 1 walnut from their bag to execute `slide_walnut(x_start)`.
R4. **Trajectory Resolution:**
- The trajectory of the rolling walnut is modeled as a ray extending from along vector:
[gap-fill] where , and is a small angle error (representing unevenness on the floor or a slight hand wobble on release).
R5. **Collision Check:**
- The ray is checked for intersection with any `floor_walnuts` within a collision radius meters.
- **Hit:** If an intersection occurs with target , the active agent wins that walnut and adds it (and their own rolling walnut) to their bag. The hit walnut is removed from `floor_walnuts`.
- **Miss:** If the ray intersects no targets, the rolling walnut comes to a stop at a random point along the ray and is added to `floor_walnuts` as a stationary target.
R6. **Empty Board Replenishment:** [gap-fill] If `floor_walnuts` is empty (all hit), every active player must immediately contribute 1 walnut to the floor to restart the target zone.
R7. **Elimination & Winning:** A player with 0 walnuts is eliminated. The game terminates when only one player remains with walnuts, or after 10 rounds. The player with the most walnuts wins.
## Edge cases
- **Tie at the end condition:** If there is a tie, the player who won the most walnuts in a single round wins the tiebreaker.
- **A player with no legal move:** Not applicable; sliding is always legal as long as the player has 1 walnut.
- **Repetition / cycles:** If players consistently miss, the count of `floor_walnuts` increases. A higher density of floor targets mathematically increases the probability of a collision, guaranteeing eventual round resolution.
- **Simultaneous claims on the same resource:** Not applicable; turns are strictly sequential.
- **Player elimination mid-round:** Removed from rotation; their walnuts on the floor remain as targets.
- **Resource exhaustion:** Not applicable.
- **Termination guarantee:** Guaranteed by finite starting assets and the 10-round cap.
## State representation
- **Persistent state:**
- `agent_walnuts`: Map of `agent_id` to integer.
- `floor_walnuts`: List of 2D coordinates representing target walnuts on the floor.
- `active_agent_index`: Integer.
- **Per-turn ephemeral state:**
- `trajectory_ray`: Ray defined by origin and direction.
## Action space
- `slide_walnut(x_start)`: Release a walnut down the ramp at . Precondition: agent has at least 1 walnut and it is their turn.
## Playability notes
- **Single-player-vs-AI:** Highly playable. The user selects on a visual slider. AI players evaluate the geometric angles to find the launch coordinate that intersects the highest density of floor targets.
- **Group games (n>4):** Generalizes easily.
- **Physical-skill games:** [gap-fill] The physical sliding roll is abstracted as a deterministic line projection with a small Gaussian noise variable simulating floor unevenness.
- **What is lost in the adaptation:** The physical construction of the ramp, the organic acceleration/momentum decay of the walnut, and the tactile feel of releasing the walnut are lost.
## Implementation hints
- Implement the 2D coordinate floor plane and a line-circle intersection algorithm to check for collisions between the rolling ray and floor walnuts.
- Build the round manager and ensure target replenishment when the floor is cleared.
- Implement an AI agent that runs a simple raycast sweep across all horizontal options to find the choice with the maximum target intersection.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Passover Walnuts - The Ramp (Israel). (n.d.). Games of Countries. https://gamesofcountries.com/games/il-israel/egozim-rampa
@misc{gamesofcountries-il-israel-egozim-rampa,
title = {Passover Walnuts - The Ramp (Israel)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/il-israel/egozim-rampa}
}