Skip to main content
Formal Specification

Mother of Holes (Sudanese Pit Pitching) — Formal Specification

Sudan · dexterity-throw · Confidence: medium

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Umm al-Hufar — AI-optimized specification ## General idea A sequential precision pitching and elimination game played on a 1D line of pit targets. Agents pitch stone markers to enter targets 1 through 4 sequentially. Reaching the final "Mother Hole" upgrades the agent to Hunter status, allowing direct projectile strikes to eliminate opposing markers. ## Formal model - **Abstraction taken:** Ground pit pitching and rolling friction are discretized into a 2D Euclidean coordinate space with 4 pit circles H1,H2,H3,H4 of radius r=0.05 m located along the y-axis at y∈{1.0,2.0,3.0,4.0} m. - **Player/agent count:** 2 agents (extensible to N). - **Turn model:** Sequential turns; active agent retains turn on landing in target hole or striking an opponent. ## Formal rules R1. Target positions: H1=(0,1),H2=(0,2),H3=(0,3),H4=(0,4). Agents start at baseline (0,0). R2. Agent State per marker: `target_hole ∈ {1, 2, 3, 4}`, `is_hunter: bool = False`, `pos: (x, y)`, `status: ACTIVE | ELIMINATED`. R3. Pitch Action: Agent at current position 𝐩curr shoots at target 𝐩aim with power F and angle θ. - Actual resting position: 𝐩new=𝐩aim+𝛜 where 𝛜∼𝒩(0,σ2(d)) and d=‖𝐩aim−𝐩curr‖. R4. Hole Entry & Progression: - If ‖𝐩new−Hk‖≤r where k=target_hole: - Pitch succeeds! Marker snaps to Hk. - If k<4: `target_hole` increments to k+1, agent gets an immediate bonus shot from Hk. - If k==4: Marker becomes `is_hunter = True`, agent gets an immediate bonus shot from H4. - If marker misses target hole: marker remains at 𝐩new, turn passes to next agent. R5. Hunter Strike & Elimination: - An agent with `is_hunter == True` may target any active opponent marker 𝐩opp. - If pitch lands within collision tolerance ‖𝐩new−𝐩opp‖≤2r: - Opponent marker is `ELIMINATED`. - Hunter earns +10 points and an immediate bonus shot. R6. [gap-fill] Turn Limit: Match terminates after 20 complete turn rotations if not concluded earlier. R7. [gap-fill] Win Condition: The last surviving agent (or the agent with the highest stage progress upon turn 20) wins. ## Edge cases - Tie at the end condition: If both agents remain active at turn 20, higher hole stage breaks ties; if equal, a sudden-death pitch to H4 decides. - A player with no legal move: Pitch actions are always available from current position. - Repetition / cycles: Bounded by the 20-rotation hard limit (R6). - Simultaneous claims on the same resource or position: Markers landing within same hole occupy distinct micro-slots; Hunter strike eliminates on proximity. - Player elimination mid-round; turn order repair: Eliminated markers are removed; turn rotation skips eliminated agents. - Resource exhaustion (pieces, tokens, space, time): Exactly 1 marker per player; 4 holes fixed. - Termination guarantee: Monotonic progress through 4 holes and elimination of opponents, bounded by 20-rotation cap. ## State representation - Persistent state: - `agent_states`: map of `agent_id` to `{pos: (x, y), target_hole: int, is_hunter: bool, status: ACTIVE | ELIMINATED}`. - `active_agent_index`: integer in `0..n-1`. - `rotation_counter`: integer in `0..20`. - Observable information: Fully observable by all agents. ## Action space - `pitch(x_aim, y_aim)`: 2D coordinate target within field bounds. ## Playability notes - Single-player-vs-AI: Natural fit for precision target challenge vs AI opponent. - Group games (n>4): Generalizes to free-for-all elimination arena with N markers on field. - Physical-skill games: Ground rolling and aiming are modeled as distance-decay Gaussian noise. - What is lost in adaptation: The tactile feel of sandy micro-troughs and physical thumb rolling. ## Implementation hints Simple 2D continuous coordinates with discrete target proximity checks. First milestone: implement hole landing detector and progression state machine before adding Hunter elimination.

Download as JSON

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

Download JSON
Cite this page

Mother of Holes (Sudanese Pit Pitching) (Sudan). (n.d.). Games of Countries. https://gamesofcountries.com/games/sd-sudan/umm-al-hufar

@misc{gamesofcountries-sd-sudan-umm-al-hufar,
  title = {Mother of Holes (Sudanese Pit Pitching) (Sudan)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/sd-sudan/umm-al-hufar}
}