Skip to main content
Formal Specification

Hand Balls / Traditional Beanbag Juggling — Formal Specification

Japan · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 3
# Otedama — AI-optimized specification ## General idea A traditional Japanese fabric beanbag dexterity game encompassing air juggling (*Yuri-dama*) and a 5-step floor scoop jacks progression (*Zara-dama*). In competitive turn-taking play, players take turns attempting the 5 progressive scooping stages, resuming from their point of failure on subsequent turns until one player completes the entire sequence. ## Formal model - **Abstraction taken:** The continuous physical hand scooping speed, finger clearance, beanbag trajectory timing, and back-of-hand catching balance are abstracted into a discrete 5-stage progression model. Each stage is resolved via a stochastic success function `P(success) = f(stage_difficulty, player_skill)`. - **Player/agent count:** 1 player (solo certification) or 2 to 6 players (standard: 2 players taking alternating turns). - **Turn model:** Sequential turns; an active player continues executing stages until a fault occurs, then yields the turn. ## Formal rules R1. Equipment setup: 5 beanbags (1 Parent / *Oyadama*, 4 Children / *Kodama*). All players start at Step 1 (`current_step = 1`). R2. The Five *Zara-dama* Progressive Stages: - Step 1 (*O-hitotsu*): Toss parent bag and scoop 1 child bag; repeated 4 times (Difficulty D=1). - Step 2 (*O-futatsu*): Toss parent bag and scoop 2 child bags simultaneously; repeated 2 times (Difficulty D=2). - Step 3 (*O-mitsu*): Toss parent bag and scoop 3 child bags, then scoop the remaining 1 bag on the second toss (Difficulty D=3). - Step 4 (*O-yotsu*): Toss parent bag and scoop all 4 child bags in a single sweeping throw (Difficulty D=4). - Step 5 (*Okaeri*): Balance all 5 bags on the back of the hand, toss upward, flip hand, and catch them in the palm (Difficulty D=5). R3. Stage execution: - For each required toss-and-scoop within the active stage `S`, success probability is: `P(success) = clamp(skill_active - 0.07 * D(S), 0.05, 0.95)`. - If all required scoops in stage `S` succeed, `current_step` increments to `S + 1`, and the player continues their turn. R4. Fault resolution: - If any toss or scoop fails, the player's turn ends immediately. - On their next turn, the player resumes attempts at their current `current_step`. R5. Victory condition: The first player to complete Step 5 (*Okaeri*) wins the game immediately. R6. [gap-fill] Step 5 catch threshold: On Step 5 (*Okaeri*), catching at least 3 of the 5 bags cleanly in the palm constitutes successful stage completion. R7. [gap-fill] Match turn cap: If no player finishes Step 5 within 25 total player turns, the match terminates, and victory is awarded to the player with the highest stage progress. R8. [gap-fill] Two-hand penalty: Attempting to assist a scoop with the non-active hand triggers an immediate fault. ## Edge cases - **Tie at the end condition:** Prevented by sequential completion of Step 5; if turn cap is reached (R7), highest step number wins (ties broken by sudden-death Step 4 trial). - **A player with no legal move:** Active player must execute the prescribed scoop actions for their current stage. - **Repetition / cycles:** Players may stall on difficult stages; bounded by non-zero success probability and the 25-turn match cap (R7). - **Simultaneous claims on the same resource or position:** Not applicable; turns are strictly sequential. - **Player elimination mid-round:** Not applicable; all players cycle turns until one completes the sequence. - **Resource exhaustion:** Exactly 5 beanbags are used throughout all stages. - **Termination guarantee:** Guaranteed by non-zero stage completion probability (`P(success) >= 0.05`) and the 25-turn match cap (R7). ## State representation - **Persistent state:** `player_steps[2]` (ints in `[1..6]`, where 6 denotes completed), `active_player` (0 or 1), `total_turns` (int in `[0..25]`). - **Per-turn state:** `sub_step_index` (int), `current_stage_difficulty` (int). - **Observable information:** Fully observable perfect-information game. ## Action space - `execute_scoop_attempt()`: Execute the required physical toss and scoop for the active stage. ## Playability notes - **Single-player-vs-AI:** Operates cleanly as a probabilistic progression race; AI models skill parameters and simulates human failure rates across stages. - **Group games (n>4):** Naturally supports 3–6 players seated in a circle taking turns. - **Physical-skill games:** Finger dexterity, hand speed, and back-of-hand balancing are modeled via stage-specific difficulty factors. - **What is lost in the adaptation:** The soft tactile feel of chirimen silk beanbags, azuki bean acoustics, and the rhythmic cadence of traditional *warabe-uta* chanting. ## Implementation hints Linear 5-stage finite state machine with Bernoulli trials. Can be coded in under 50 lines. First milestone: implement 5-stage progression with turn swapping upon failure and evaluate average turns to victory across skill ranges.

Download as JSON

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

Download JSON
Cite this page

Hand Balls / Traditional Beanbag Juggling (Japan). (n.d.). Games of Countries. https://gamesofcountries.com/games/jp-japan/otedama

@misc{gamesofcountries-jp-japan-otedama,
  title = {Hand Balls / Traditional Beanbag Juggling (Japan)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/jp-japan/otedama}
}