Skip to main content
Formal Specification

Yangamini (Marble-Hole Throwing Game) — Formal Specification

Australia · dexterity-throw · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: discretizedGap-fills: 1
# Yangamini (Marble-Hole Throwing Game) — AI-optimized specification ## General idea Players take turns throwing marbles underarm at a hole in the ground; a marble that lands in the hole is kept by its owner, one that misses is forfeited into the hole, and the winner is whoever still holds a marble once everyone else's have been forfeited. ## Formal model State: for each player, a count of marbles currently held; a running total of forfeited marbles in the hole (not owned by anyone, out of play); turn order among players still holding at least one marble. ## Formal rules R1. On a player's turn, they throw one marble underarm at the hole. R2. If the marble lands in the hole, [gap-fill] assume it is immediately retrieved by the thrower and returns to their held count, since the source's overall win condition (last player still holding a marble) only makes sense if landing in the hole does not itself deplete the thrower's supply — misses are what deplete it (R3). R3. If the marble misses the hole, it is placed into the hole and removed from the game permanently (forfeited). R4. Turn order cycles among all players who still hold at least one marble. R5. A player whose marble count reaches zero is out of marbles to throw and drops out of the active rotation. R6. The last player still holding any marble is the winner. R7. The winner redistributes all forfeited marbles among the players to start a new game. ## Edge cases Tie at end condition: not applicable — R6 guarantees a unique last-holder outcome once forfeiture (R3) is monotonic and irreversible. No legal move: a player with zero marbles has no legal throw and is simply skipped in turn order (R5) rather than failing a turn. Repetition/cycles: not applicable — each throw permanently resolves (marble either returns to the thrower's count or leaves the game). Simultaneous conflicting actions: not applicable — players throw one at a time in turn order. Mid-round elimination: a player reaching zero marbles is functionally eliminated from throwing but remains a spectator until the round ends (R5); this is a natural, documented elimination, not an edge case requiring a gap-fill. Resource exhaustion: the total marble supply is fixed at the round's start and only decreases (into the hole) until one player holds it all; this is the core win condition, not a failure state. Termination guarantee: guaranteed — each miss strictly and irreversibly reduces the total number of marbles in circulation among players, so the round must end in finite throws. ## State representation (player_marbles: dict[player_id -> int], hole_forfeit_count: int, active_players: list[player_id], current_thrower_index: int) ## Action space throw(player) — attempt to land the player's marble in the hole; resolves to hit (R2) or miss (R3). ## Playability notes The R2 gap-fill (landed marbles are retrieved and remain the thrower's) is necessary to make the stated win condition coherent, since the source states the winner is 'the last player to have a marble' without spelling out the retrieval step explicitly. Throw accuracy itself is not given a probability model by the source; a playable implementation must supply an explicit, flagged skill/accuracy parameter. ## Implementation hints This game reduces cleanly to a simple depleting-resource elimination game; a minimal implementation just needs a per-player marble counter and a single accuracy-check function per throw. The non-competitive team variant (Variants) is a useful alternative mode with no elimination — worth exposing as a toggle rather than a separate implementation.

Download as JSON

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

Download JSON
Cite this page

Yangamini (Marble-Hole Throwing Game) (Australia). (n.d.). Games of Countries. https://gamesofcountries.com/games/au-australia/yangamini

@misc{gamesofcountries-au-australia-yangamini,
  title = {Yangamini (Marble-Hole Throwing Game) (Australia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/au-australia/yangamini}
}