Skip to main content
Formal Specification

Afghan Marbles — Formal Specification

Afghanistan · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 4
# Tishla-bāzī — AI-optimized specification ## General idea A sequential precision marble shooting and elimination game. Agents flick a shooter marble (*tīr*) with the thumb to navigate a linear sequence of three ground pits (*kull*) forward and backward (Pit 1 → 2 → 3 → 2 → 1). Completing the circuit elevates the shooter to "Master" (*Ostad*) status, unlocking the ability to hunt and strike opponent marbles to eliminate them and claim their marbles as winnings. ## Formal model - **Abstraction taken:** Continuous physical rolling on dirt, thumbnail flick mechanics (*feng-zadan*), and ground micro-undulations are abstracted into a 2D continuous coordinates field with 3 circular pit targets and stochastic shot dispersion parameterized by distance and agent aim skill. - **Player/agent count:** 2 to 6 individual agents. - **Turn model:** Strictly sequential turns, where a successful pit entry or target strike grants an immediate consecutive shot from the current landing position. ## Formal rules R1. **Setup:** The field has 3 aligned pits along the X-axis: Pit 1 at (2.0,0), Pit 2 at (5.0,0), Pit 3 at (8.0,0), each with radius rpit=0.05m. Baseline is at (0,0). Each agent starts at the baseline with 1 shooter marble. R2. **Turn Order Lag Toss:** All agents toss a marble toward Pit 1 from the baseline. Turn order is sorted ascending by distance to Pit 1. [gap-fill: proximity sorting for initial turn order]. R3. **Circuit Progression:** Each agent tracks `pit_stage` ∈[1,5] corresponding to target pits: - Stage 1: Pit 1 (2.0,0) - Stage 2: Pit 2 (5.0,0) - Stage 3: Pit 3 (8.0,0) - Stage 4: Pit 2 (5.0,0) (return leg) - Stage 5: Pit 1 (2.0,0) (return leg) - Stage 6: `is_ostad = true` (Master status attained) R4. **Turn Actions & Shot Execution:** On their turn, an agent selects a target and power vector: `SHOOT(target_x, target_y, power)`. - The actual landing coordinate (x′,y′) is sampled: (x′,y′)∼𝒩((target_x,target_y),Σskill). - **Pit Check (for Non-Ostad):** If the agent aimed at their current target pit and dist((x′,y′),Pit)≤rpit, the shot succeeds: `pit_stage` increments by 1. The agent earns an immediate extra shot from the lip of that pit. - **Hunting Check (for Ostad):** If `is_ostad == true`, the agent may target any opponent marble j at (xj,yj). A hit occurs if dist((x′,y′),(xj,yj))≤2×rmarble (rmarble=0.01m). Struck opponent is eliminated (`status = ELIMINATED`), and the Ostad earns +1 captured marble and an immediate extra shot. - **Miss:** If a shot fails to sink in the target pit or miss the opponent marble, the shooter marble comes to rest at (x′,y′), and the turn ends. R5. **Fouls (*Duzdī*):** Any deliberate advancing of the hand ("creeping") is penalized by resetting the marble to its previous position and ending the turn. [gap-fill: creeping penalty formalized]. R6. **Round End & Victory:** The round ends when only 1 surviving active agent remains on the field, or after a maximum of M=30 full rotation cycles. The last surviving agent (or the agent with the highest count of captured marbles) wins. [gap-fill: 30-cycle timeout safety cap]. ## Edge cases - Tie at the end condition: If multiple agents survive when the 30-cycle timeout triggers, the agent with the highest count of eliminated/captured opponents wins; if tied, a sudden-death single-shot toss at Pit 1 resolves the tie. [gap-fill: sudden death toss for ties]. - A player with no legal move: Not applicable; an active agent always has a valid `SHOOT` action. - Repetition / cycles: Bounded strictly by the elimination of players and the 30-cycle maximum rotation limit. - Simultaneous claims on the same resource or position: Turns are strictly sequential; marbles occupy continuous 2D coordinates; if a marble strikes a resting marble, collision mechanics displace both without positional conflict. - Player elimination mid-round; turn order repair: Eliminated agents are removed from the active rotation list; the turn index advances seamlessly to the next active agent. - Resource exhaustion (pieces, tokens, space, time): The active player count is strictly non-increasing. The 30-cycle clock strictly exhausts. - Termination guarantee: Provably terminates because Ostad players systematically hunt and eliminate non-Ostad opponents, bounded by the 30-cycle timeout. ## State representation - **Persistent state:** - `agents`: list of active agent IDs - `agent_states`: map of `agent_id -> {pos: (x, y), pit_stage: 1..5, is_ostad: boolean, captured_marbles: integer, status: ACTIVE | ELIMINATED}` - `active_turn_index`: integer - `cycle_count`: integer (1..30) - **Per-turn ephemeral state:** - `intended_target`: `{x, y}` - `sampled_landing`: `{x, y}` - `hit_event`: `{success: boolean, type: PIT | OPPONENT, target_id: agent_id | None}` - **Observable information:** Fully observable. Positions of all marbles on the field, pit stages, Ostad status, and captured tallies are public. ## Action space - `shoot(target_x, target_y, power)`: - `(target_x, target_y)`: 2D coordinates of intended target (a pit center or an opponent's marble). - `power`: float in range [0.1,1.0]. - Preconditions: Agent is the active player and `status == ACTIVE`. ## Playability notes - Single-player-vs-AI: Highly tactical and replayable. AI agents compute geometric angles, balancing racing through the pits to become Ostad first versus shooting at exposed rivals or seeking defensive cover. - Group games (n>4): Scales naturally from 2 to 6 players; higher player counts increase the density of targets on the field and heighten the urgency of attaining Ostad status. - Physical-skill games: Thumb flicking force and angle precision are parameterized via Gaussian landing variance matrices based on distance and skill. - What is lost in the adaptation: The tactile glass marble texture, thumb knuckle calluses, and intense playground bartering of prized marble designs. ## Implementation hints Low-to-medium complexity. State machine combines linear stage tracking with 2D Euclidean distance collision tests. Suggested first milestone: implement the 5-stage pit navigation and extra-shot loop for a single agent, then add multi-agent marble targeting and elimination.

Download as JSON

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

Download JSON
Cite this page

Afghan Marbles (Afghanistan). (n.d.). Games of Countries. https://gamesofcountries.com/games/af-afghanistan/tishla-bazi

@misc{gamesofcountries-af-afghanistan-tishla-bazi,
  title = {Afghan Marbles (Afghanistan)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/af-afghanistan/tishla-bazi}
}