Formal Specification
One Pebble Two Pebbles (Persian Jacks) — Formal Specification
Iran · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Yeh Ghol Do Ghol — AI-optimized specification
## General idea
A sequential five-stone manual dexterity game modeled as a progressive state machine across 6 stages of escalating motor complexity, concluding with a stochastic risk-reward hand-catch scoring phase.
## Formal model
- **Abstraction taken:** Physical hand scooping, finger flicking, and back-of-hand catching are modeled as parameterized stochastic skill checks `P(success) = f(stage_difficulty, agent_dexterity)`. State tracks individual progress per player.
- **Player/agent count:** `N` individual agents (`2 <= N <= 6`).
- **Turn model:** Sequential turn-based progression. Active agent plays until committing a foul, then passes turn.
## Formal rules
R1. Stage Hierarchy:
- Stages: `1 (Ones) -> 2 (Twos) -> 3 (Threes) -> 4 (Fours) -> 5 (Bridge) -> 6 (Scoring)`.
- Each player maintains persistent progress pointer `stage[player] ∈ [1..6]`.
R2. Stage Execution & Success Probabilities:
- **Stage 1 (Ones):** 4 sequential attempts. `P(step) = dexterity * 0.90`.
- **Stage 2 (Twos):** 2 sequential attempts. `P(step) = dexterity * 0.82`.
- **Stage 3 (Threes):** 2 sequential attempts (triple + single). `P(step) = dexterity * 0.78`.
- **Stage 4 (Fours):** 2 sequential attempts (drop + sweep). `P(step) = dexterity * 0.72`.
- **Stage 5 (Bridge):** 4 finger flicks through hand bridge. `P(step) = dexterity * 0.65`.
R3. Stage 6 (Shah-Nishin Scoring):
- Agent attempts back-of-hand toss:
- Count caught on back of hand: `k ~ Binomial(5, dexterity * 0.75)`. [gap-fill]
- If `k > 0`, agent attempts palm-catch:
- Final points scored: `pts ~ Binomial(k, dexterity * 0.85)`.
- `scores[player] += pts`.
- `stage[player]` resets to 1 (new cycle begins).
R4. Foul Resolution (*Sookhtan*):
- If any stage attempt fails, active player fouls: turn ends immediately.
- Player retains current stage index for their next turn.
R5. Win Condition:
- First player to achieve `target_score` (default 20 points) wins the match.
## Edge cases
- **Tie at the end condition:** If multiple players reach target score in the same round, a single Stage 6 tiebreak toss is held.
- **A player with no legal move:** Active player always has the execution action corresponding to their current stage.
- **Repetition / cycles:** Bounded because non-zero success probabilities and monotonic score accumulation drive progress toward target score.
- **Simultaneous claims on resources:** Not applicable; strictly sequential turns.
- **Player elimination mid-round:** Players do not get eliminated; progress is preserved across turns.
- **Resource exhaustion:** Five stones are persistent.
- **Termination guarantee:** Guaranteed by positive score accumulation per completed cycle.
## State representation
- **Persistent state:**
- `scores: Array[N] of int`.
- `stage: Array[N] of int` (1..6).
- `sub_step: Array[N] of int` (sub-progress within active stage).
- `active_player: int` (0..N-1).
- `target_score: int`.
- **Information set:** Perfect information, fully observable.
## Action space
- `execute_stage_action()`: Precondition: active player turn, `stage[player] < 6`.
- `execute_scoring_throw()`: Precondition: active player turn, `stage[player] == 6`.
## Playability notes
- **Single-player-vs-AI:** Highly playable. Models the classic tension of passing through stages cleanly and scoring maximum points on Shah-Nishin.
- **Group games:** Scales naturally for 2 to 6 players.
- **Physical-skill model:** Complex finger dexterity and ballistics are abstracted into parameterized binomial and Bernoulli distributions.
- **What is lost:** Tactile weight and surface friction of natural polished river stones.
## Implementation hints
Implement as a compact finite state machine with 6 stage handlers. Verify that a foul cleanly preserves stage progress without advancing the player index until the next turn cycle.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
One Pebble Two Pebbles (Persian Jacks) (Iran). (n.d.). Games of Countries. https://gamesofcountries.com/games/ir-iran/yeh-ghol-do-ghol
@misc{gamesofcountries-ir-iran-yeh-ghol-do-ghol,
title = {One Pebble Two Pebbles (Persian Jacks) (Iran)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ir-iran/yeh-ghol-do-ghol}
}