Skip to main content
Formal Specification

Hazelnut Rolling (Nut Striking / Riekstu Sišana) — Formal Specification

Latvia · dexterity-throw · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 8
# Riekstu ripināšana — AI-optimized specification ## General idea An autumn harvest turn-based rolling and target capture game. Players roll hazelnuts down an inclined chute toward a cluster of target nuts scattered on a floor; striking a resting hazelnut captures it into the player's scoring stash and awards an extra roll, while a missed nut remains on the floor as an additional target for opponents. ## Formal model - **Abstraction taken:** Physical rolling dynamics of asymmetric hazelnuts (wobble along the suture line, wooden floor friction, and elastic nut-on-nut collisions) are abstracted into a 2D trajectory simulator with angular dispersion. The agent selects launch angle θ and speed v0; the path is traced over a 2D landing plane testing for circle-circle collisions against stationary nuts (radius rnut=1.0 cm). - **Player/agent count:** 2 to 8 agents (2≤N≤8). - **Turn model:** Sequential cyclic turn rotation, retaining the turn upon any successful hit. ## Formal rules R1. **Initial board setup:** Incline base fixed at (0,0) facing +y. Initial target cluster of Ntarget=10 stationary hazelnuts initialized in the target zone [−20,20]×[30,80] cm [gap-fill]. R2. **Inventory setup:** Each agent begins with a personal reserve of Hstart=10 hazelnuts [gap-fill]. R3. **Roll action:** - Active agent chooses launch angle θ∈[−π/6,π/6] and release speed v0∈[0.5,3.0] m/s [gap-fill]. - Nut path is generated with trajectory wobble: Δθ(t)∼𝒩(0,σwobble2) [gap-fill]. R4. **Hit resolution:** - If the rolling nut comes within distance d≤2rnut=2.0 cm of any stationary nut on the floor: - A hit is confirmed. - The active agent retrieves the rolling nut and collects all struck target nut(s) into their score stash [gap-fill]. - The active agent receives an immediate bonus roll. R5. **Miss resolution:** - If the rolling nut comes to rest at (xstop,ystop) without contacting any stationary nut: - The nut remains at (xstop,ystop) as a new stationary target. - The agent's hand reserve decreases by 1, and the turn passes to the next player. R6. **Player out of nuts:** An agent with 0 nuts in hand reserve is skipped during turn rotation [gap-fill]. R7. **Game end and winning:** - The match terminates when all floor target nuts are captured, or when all players have 0 nuts in hand reserve [gap-fill]. - The agent with the largest total count of collected hazelnuts in their score stash is the winner. ## Edge cases - Tie at the end condition: if multiple players have identical winning nut counts, tie is broken by fewest misses committed during the match; if still equal, resolved as a shared victory [gap-fill]. - A player with no legal move: an agent with 0 nuts in hand has no legal roll and is skipped per R6. - Repetition / cycles: bounded because total nuts in play is strictly finite (Ntarget+N⋅Hstart); every miss reduces total hand reserve, guaranteeing finite termination. - Simultaneous claims on the same resource or position: collisions resolve sequentially along the rolling trajectory. - Player elimination mid-round: an agent whose hand reserve reaches 0 is skipped; other agents continue until the end condition is met. - Resource exhaustion: hand reserves decrease monotonically on misses, terminating the game via R7. - Termination guarantee: guaranteed by the finite non-renewable nut supply and non-zero miss probability. ## State representation - Persistent state: player IDs, turn rotation list, cumulative captured nuts per agent. - Per-turn ephemeral state: hand reserves (H1…HN), stationary nut coordinates on the floor {(xj,yj)}, active turn player, bonus roll flag. - Observable information: full public observability — all hand reserves, floor target positions, and score tallies are fully visible to all agents. ## Action space - `roll_nut(angle, speed)`: execute hazelnut release from incline with angle θ∈[−π/6,π/6] and speed v0∈[0.5,3.0]. Precondition: active turn holder, hand reserve >0. ## Playability notes - Single-player-vs-AI: natural — human vs 1 or more AI agents evaluating risk-reward of cluster targeting vs isolated target pickups. - Group games (n>4): natively supports 2 to 8 players without modification. - Physical-skill games: nut shape irregularity and floor friction abstracted into parameterized wobble dispersion and decelerating rolling friction. - What is lost: tactile shell texture, cracking shells, and joyful Michaelmas feast atmosphere. ## Implementation hints Low complexity. Identical architectural pattern to `olu-ripinasana` with scaled spatial parameters (centimetres instead of metres) and higher nut counts. First milestone: implement 2D trajectory generation with friction and circular target intersection tests.

Download as JSON

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

Download JSON
Cite this page

Hazelnut Rolling (Nut Striking / Riekstu Sišana) (Latvia). (n.d.). Games of Countries. https://gamesofcountries.com/games/lv-latvia/riekstu-ripinasana

@misc{gamesofcountries-lv-latvia-riekstu-ripinasana,
  title = {Hazelnut Rolling (Nut Striking / Riekstu Sišana) (Latvia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/lv-latvia/riekstu-ripinasana}
}