Formal Specification
Mother of Holes (Sudanese Pit Pitching) — Formal Specification
Sudan · dexterity-throw · Confidence: medium
← Back to game pageImplementation 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 of radius located along the -axis at .
- **Player/agent count:** 2 agents (extensible to ).
- **Turn model:** Sequential turns; active agent retains turn on landing in target hole or striking an opponent.
## Formal rules
R1. Target positions: . Agents start at baseline .
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 shoots at target with power and angle .
- Actual resting position: where and .
R4. Hole Entry & Progression:
- If where :
- Pitch succeeds! Marker snaps to .
- If : `target_hole` increments to , agent gets an immediate bonus shot from .
- If : Marker becomes `is_hunter = True`, agent gets an immediate bonus shot from .
- If marker misses target hole: marker remains at , turn passes to next agent.
R5. Hunter Strike & Elimination:
- An agent with `is_hunter == True` may target any active opponent marker .
- If pitch lands within collision tolerance :
- Opponent marker is `ELIMINATED`.
- Hunter earns 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 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 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 JSONCite 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}
}