Skip to main content
Formal Specification

Buganda Royal 4-Row Mancala — Formal Specification

Uganda · board-abstract · Confidence: medium

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: directGap-fills: 3
# Omweso (Omweso) — AI-optimized specification ## General idea A Buganda mancala game played on a 4x8 board with 64 counters, featuring customizable opening seed marshaling (ékyeso), relay-sowing (ókwesa), dual-row captures (kutta), and reverse-direction captures (kutebuka) with a 9-counter movement limit. ## Formal model - **Abstraction taken:** none needed beyond the source — Omweso is already a discrete board game with a fully defined state (hole contents) and legal-move set. All 64 counters remain in play for the whole game; capturing transfers counters between players without removing them from the board. - **Player/agent count:** 2 (or 2 teams of players controlling one side). - **Turn model:** strictly alternating turns after opening setup. ## Formal rules R1. Board: 4 rows x 8 holes (32 total), 64 counters (all counters stay in play for the whole game; none are eliminated, only transferred). R2. Setup: 32 counters per side, arranged into a chosen starting configuration (ékyeso). [gap-fill: whether starting layouts must be announced simultaneously or placed in secret is undocumented — implementers may default to simultaneous reveal] R3. Legal sow: scoop all counters (minimum 2) from an own hole and sow one per hole counter-clockwise. R4. Relay-sowing: if the last counter lands in an occupied hole, scoop all counters from that hole and continue sowing from the next hole onward; the sow ends when the last counter lands in an empty hole. R5. "Exposed" condition: an opponent hole is exposed if BOTH the front-row hole AND the back-row hole directly behind it hold counters simultaneously. R6. Normal capture (Kutta): if the final counter of a sow lands in an own occupied hole directly opposite an exposed opponent pair, capture all counters from both holes and sow them onward from the next hole, chaining further captures if the newly added counters again end in a hole facing an exposed pair. [gap-fill: whether capture is mandatory when available is not stated in the source — treat capture as optional unless a clearer source says otherwise] R7. Reverse capture (Kutebuka): from either of the two leftmost holes in either row, a player may reverse direction (sow clockwise) to capture exposed counters, up to a maximum of 9 counters in a single reverse chain; the player then resumes normal forward sowing using the captured counters. A player is never required to make a reverse move. R8. Win condition: a player loses when every one of their holes holds fewer than 2 counters (i.e. no legal sow is possible; single counters cannot be moved). R9. Match/set victory variants (cultural rules; documented for Buganda): - Double score (ókutema): capturing both extreme end-of-row hole pairs in one move (worth 2 scores). - Full set (akawumbi): capturing all 64 counters in a single move (worth 12 scores). - Knock-out (ókutema, second sense): winning by capturing twice before the opponent captures at all (worth 2 scores). [gap-fill: these are match-scoring multipliers, not single-game rules; single-game engines may ignore them, while match engines should layer them on top of the R8 loss check] R10. Draw: not documented in the primary ethnographic source (Nsimbi 1968) — a game ends only by a player reaching an unplayable state. ## Edge cases - **Tie at the end:** unaddressed in source; player with no legal move loses immediately, so a tie does not occur in normal play. - **A player with no legal move:** losing condition under R8 (no legal sow possible when every hole holds fewer than 2 counters). - **Repetition / cycles:** relay-sowing can in principle cycle; not formally proven to terminate in general — implementers should impose a move-count cap as a safety bound. - **Simultaneous claims on one position:** not applicable — strictly sequential turns, each fully resolved before the opponent acts. - **Elimination mid-round and turn-order repair:** not applicable; two-player game with no player elimination; counters transfer between sides, never removed from the 64-counter conservation pool. - **Resource exhaustion:** all 64 counters remain on the board; counters concentrate as captures occur until one player is left with no hole holding 2+ counters. - **Termination guarantee:** not formally guaranteed in the general case — mancala games with relay sowing can in principle cycle, though captures steadily concentrate counters; implementers should impose a move-count cap as a safety bound. ## State representation - `board`: array[2][2][8] of counter counts (player, row, hole). - `to_move`: player index. ## Action space - `sow_forward(row, hole)` — scoop ≥2 counters and sow counter-clockwise. - `sow_reverse(row, hole)` — execute Kutebuka reverse capture from legal left hole. ## Playability notes - Exceptional depth; strategic opening marshaling and tactical reverse captures make it one of the deepest combinatorial games in the corpus. - Fully deterministic; perfect information. ## Implementation hints Implement forward relay-sowing and Kutebuka reverse-sowing as separate branches; strictly enforce the 9-counter reverse limit and dual-hole capture conditions.

Download as JSON

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

Download JSON
Cite this page

Buganda Royal 4-Row Mancala (Uganda). (n.d.). Games of Countries. https://gamesofcountries.com/games/ug-uganda/omweso

@misc{gamesofcountries-ug-uganda-omweso,
  title = {Buganda Royal 4-Row Mancala (Uganda)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/ug-uganda/omweso}
}