Formal Specification
Al-Sakja (Sudanese Crown Cap Flicking) — Formal Specification
Sudan · dexterity-small · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Al-Sakja — AI-optimized specification
## General idea
A turn-based bottle-cap flicking and territory control game on a 2D plane. Agents flick weighted disk caps into successive box cells or directly at opponent caps. Successful strikes award captures and bonus shots, while conquering all cells grants proprietary ownership of restricted zones.
## Formal model
- **Abstraction taken:** Ground sliding physics and disk-to-disk impacts are modeled in a 2D Euclidean coordinate space with Coulomb kinetic friction and elastic circular disk collision physics.
- **Player/agent count:** 2 agents (extensible to ).
- **Turn model:** Sequential turns; active agent retains turn upon successfully striking an opponent or advancing a stage.
## Formal rules
R1. Setup: A rectangular grid containing 6 numbered cells of size is positioned in . Both agents start with 1 shooter cap at baseline .
R2. On a turn, active agent selects flick parameters where (force) and (angle).
R3. Sliding Dynamics:
- Initial velocity where .
- Velocity integrates under friction until coming to rest at .
R4. Collisions & Captures:
- If active cap collides with opponent cap at :
- Momentum transfer scatters opponent cap.
- If opponent cap is pushed out of bounds: opponent cap is `CAPTURED` (+10 points to active agent), and active agent earns an immediate bonus flick from .
R5. House Progression:
- If cap comes to rest inside current target cell :
- Agent advances to and earns an immediate bonus flick.
- Upon clearing , agent claims as a `OWNED_HOUSE` (opponent caps landing in are captured).
R6. [gap-fill] Miss Transition: If a flick neither advances a stage nor strikes an opponent, the turn passes to the next agent.
R7. [gap-fill] Match Termination: Game terminates after 20 turn cycles or when an agent captures the opponent's shooter. Highest score wins.
## Edge cases
- Tie at the end condition: Equal scores at cycle 20 trigger a single 1v1 sudden-death direct strike duel.
- A player with no legal move: Directional flick actions are always available from current rest position.
- Repetition / cycles: Friction strictly halts motion each turn; match bounded by 20 cycles (R7).
- Simultaneous claims on the same resource or position: Elastic disk collision equations prevent spatial overlap.
- Player elimination mid-round; turn order repair: Direct cap capture ends the round in the active agent's favor.
- Resource exhaustion (pieces, tokens, space, time): Exactly 1 shooter per player; 20 cycles max.
- Termination guarantee: Constant friction and finite cycle limit guarantee termination.
## State representation
- Persistent state:
- `agent_states`: map of `agent_id` to `{pos: (x, y), target_stage: int in 1..6, owned_houses: set[int], score: int}`.
- `active_agent_index`: integer in `0..n-1`.
- `cycle_counter`: integer in `0..20`.
- Observable information: Fully observable by all agents.
## Action space
- `flick(force, angle)`: .
## Playability notes
- Single-player-vs-AI: Engine-ready; play as human vs AI in target progression or direct duel modes.
- Group games (n>4): Supports multi-player elimination tournaments.
- Physical-skill games: Finger flicking velocity and sand trajectory adjustments are modeled as friction integration with Gaussian noise.
- What is lost in adaptation: The tactile feel of weighted wax caps and dirt surface micro-bumps.
## Implementation hints
Standard 2D disk friction and collision simulator. First milestone: implement Coulomb friction stop integrator and rectangular cell containment checks before adding disc-to-disc impulse scattering.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Al-Sakja (Sudanese Crown Cap Flicking) (Sudan). (n.d.). Games of Countries. https://gamesofcountries.com/games/sd-sudan/al-sakja
@misc{gamesofcountries-sd-sudan-al-sakja,
title = {Al-Sakja (Sudanese Crown Cap Flicking) (Sudan)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/sd-sudan/al-sakja}
}