Skip to main content
Formal Specification

Ball Song / Keep-up Ball — Formal Specification

Australia · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: directGap-fills: 6
# Hti wed (Kai) — Meriam keep-up ball — AI-optimized specification ## General idea A cooperative keep-it-up game: a circle of players relay-strikes a light ball upward, paced by a repeating song, with the informal social sanction of jeering — not elimination — for a drop. This spec formalizes it as a cooperative score-maximization game against a shared fail probability. ## Formal model - **Abstraction taken:** "skill at striking" is replaced with a per-strike `P(success)` roll, since no source detail describes what physically causes a drop. - **Player/agent count:** n=4-8, arranged in a fixed circle order. - **Turn model:** sequential, strict circle order. ## Formal rules 1. Ball starts with player 0. 2. On a player's turn, roll `P(success)`; if it succeeds, ball passes to the next player in circle order and the shared streak counter increments. 3. If it fails, [gap-fill] the streak counter resets to 0 and play continues from the next player (source does not specify elimination, only jeering). 4. Two-sided variant: [gap-fill] alternate which side's member holds the streak counter credit; side with the higher streak total after a fixed number of rounds wins — this scoring convention is invented, since the source is silent on it. ## Edge cases - End-condition ties: two-sided variant — [gap-fill] a tied streak total after the fixed round count is a draw, since no tiebreaker is recorded. - A player with no legal move: not applicable — a player always has exactly one action (strike). - Repetition and cycles: the circle-order cycle is the core loop by design, not a failure state. - Simultaneous conflicting actions: not applicable — strictly sequential, one striker at a time. - Mid-round elimination and turn-order repair: not applicable in the single-circle mode; no elimination is recorded. - Resource exhaustion: not applicable — no consumable resource. - Termination guarantee: single-circle mode is open-ended by nature (a keep-up game); [gap-fill] cap at a fixed round count to guarantee termination for implementation. ## State representation `{holder_index: int, streak: int, side_scores: [int, int] (two-sided mode only)}` ## Action space Per turn: `strike()` (only action available). ## Playability notes Reduction to 2 agents: not a natural fit since the game is fundamentally n-cooperative; [gap-fill] reduce to 2 agents each controlling half the circle in the two-sided variant, which destroys the individual streak-building tension within a side. ## Implementation hints The fail-probability model, the streak-reset-not-elimination rule, and the two-sided scoring convention are all [gap-fill]; the song's role as a pacing metronome (not a mechanic) should be preserved as flavor only.

Download as JSON

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

Download JSON
Cite this page

Ball Song / Keep-up Ball (Australia). (n.d.). Games of Countries. https://gamesofcountries.com/games/au-australia/hti-wed-ball-keepup

@misc{gamesofcountries-au-australia-hti-wed-ball-keepup,
  title = {Ball Song / Keep-up Ball (Australia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/au-australia/hti-wed-ball-keepup}
}