Formal Specification
Hazelnut Rolling (Nut Striking / Riekstu Sišana) — Formal Specification
Latvia · dexterity-throw · Confidence: low
← Back to game pageImplementation 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 ; the path is traced over a 2D landing plane testing for circle-circle collisions against stationary nuts (radius cm).
- **Player/agent count:** 2 to 8 agents ().
- **Turn model:** Sequential cyclic turn rotation, retaining the turn upon any successful hit.
## Formal rules
R1. **Initial board setup:** Incline base fixed at facing . Initial target cluster of stationary hazelnuts initialized in the target zone cm [gap-fill].
R2. **Inventory setup:** Each agent begins with a personal reserve of hazelnuts [gap-fill].
R3. **Roll action:**
- Active agent chooses launch angle and release speed m/s [gap-fill].
- Nut path is generated with trajectory wobble: [gap-fill].
R4. **Hit resolution:**
- If the rolling nut comes within distance 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 without contacting any stationary nut:
- The nut remains at 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 (); 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 , stationary nut coordinates on the floor , 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 and speed . Precondition: active turn holder, hand reserve .
## 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 JSONCite 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}
}