Formal Specification
Ugandan Marble Flicking — Formal Specification
Uganda · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: directGap-fills: 1
# Duulu (Dool) — AI-optimized specification
## General idea
A target-flicking marble game: players flick their marble at a hole or at opponents'
marbles for points, racing to a target score.
## Formal model
- **Abstraction taken:** the physical flick/aim is modeled as a hit-probability check
rather than simulated trajectory physics.
- **Player/agent count:** 2+.
- **Turn model:** sequential turns, order set by an initial closest-to-hole toss.
## Formal rules
R1. Setup: each player has one marble. An initial toss from the boundary line determines
turn order — the player whose marble lands nearest the hole goes first.
R2. On a turn, the active player flicks their marble, targeting either the hole or
another player's marble.
R3. Resolve the attempt via `P(hit) = f(player_skill, target_distance)`.
R4. A successful hit (hole or opposing marble) scores the active player 1 point.
R5. A miss passes the turn to the next player. [gap-fill: turn order after the first
round — whether it is fixed from the initial toss or determined some other way each
round — is not specified by the source; default to a fixed rotation from the initial
toss order.]
R6. Win condition: the first player to reach a pre-agreed target score (commonly 25)
wins.
## Edge cases
- **Tie at the end:** tie at target score (simultaneous point in a hypothetical simultaneous-resolution variant) is not applicable under sequential turns (R2) — only one player acts at a time, so no tie can occur mid-game.
- **A player with no legal move:** not applicable; active player executes a marble flick on their turn.
- **Repetition / cycles:** sequential flick rounds continue until target score is reached; point totals are non-decreasing.
- **Simultaneous claims on one position:** sequential turns preclude simultaneous claims on target holes.
- **Elimination mid-round and turn-order repair:** not applicable; no player elimination; turn rotation remains invariant throughout.
- **Resource exhaustion:** target score is finite and fixed at game start (R6).
- **Termination guarantee:** guaranteed — score strictly increases only on a hit, target score is finite and fixed at game start (R6), so the game terminates in a bounded number of turns given a non-zero hit probability.
## State representation
- `scores`: array of int, one per player.
- `turn_order`: fixed list of player IDs, set at setup (R1).
- `to_move`: index into `turn_order`.
- `target_score`: int, agreed before play (commonly 25).
## Action space
- `flick(player_id, target)` — target in {hole, opponent_marble_id}.
## Playability notes
- Simple, fully deterministic turn structure with one stochastic resolution step (R3) —
straightforward to implement as a probability-driven turn-based game.
- Nothing structurally is lost in adaptation beyond the physical flicking skill itself,
which is abstracted into `P(hit)`.
## Implementation hints
Implement R2-R6 directly; treat R1's initial-toss tie-break (two marbles equally close
to the hole) as an unhandled edge case to add if needed, since the source does not
address it.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Ugandan Marble Flicking (Uganda). (n.d.). Games of Countries. https://gamesofcountries.com/games/ug-uganda/duulu
@misc{gamesofcountries-ug-uganda-duulu,
title = {Ugandan Marble Flicking (Uganda)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ug-uganda/duulu}
}