Skip to main content
Formal Specification

Lebanese Marbles — Formal Specification

Lebanon · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 3
# Al-Kalal — AI-optimized specification ## General idea The traditional Lebanese marble shooting game (*Al-Kalal* / *Al-Beil*). Players shoot a large shooter marble (*Ras*) into a small hole (*Al-Joura*) to become armed as the hunter (*Al-Qatil*), then strike and eliminate opponent marbles to capture them. ## Formal model - **Arena structure:** 2D plane with a circular target hole (*Joura*) of radius r=0.05m at (0,0). Baseline at distance D=4.0m. - **Player/agent count:** 2 to 6 individual players. - **Turn model:** Sequential shooting turns. Hitting the target hole or striking an opponent grants an immediate bonus shot. ## Formal rules R1. **Arming requirement:** - A player must sink their *Ras* into the *Joura* at (0,0) to activate *Armed* status. - Sinking the *Ras* grants an immediate bonus shot from the hole rim. R2. **Hunting & elimination:** - An *Armed* player flicks their *Ras* at any opponent marble on the field. - If a collision occurs: - The struck opponent is eliminated from the round and forfeits 1 marble from reserve to the shooter. - The shooter gains a bonus shot from the impact location. - If a shot misses: Turn ends, and shooter remains at its resting spot. R3. **Victory condition:** The round terminates when all opponent marbles are eliminated. The last standing player wins the pooled marble bounty. R4. [gap-fill] Boundary penalty:** Shooting outside the 5-meter arena perimeter incurs a 1-turn penalty. R5. [gap-fill] Max turn cycles:** 25 turn cycles per player maximum. ## Edge cases - **Tie at the end condition:** Sudden death marble shoot-out from baseline to hole [gap-fill]. - **A player with no legal move:** Flick action always available. - **Repetition / cycles:** Monotonic player elimination and 25-cycle limit. - **Simultaneous claims:** Turn-based resolution. - **Player elimination mid-round:** Eliminated players exit active arena. - **Resource exhaustion:** Monotonically decreasing active shooters. - **Termination guarantee:** Provably terminates when 1 active player remains. ## State representation - **Persistent state:** `marble_reserves: Dict[PlayerID, int]`. - **Ephemeral state:** `positions: Dict[PlayerID, (float, float)]`, `is_armed: Dict[PlayerID, bool]`, `active_players: Set[PlayerID]`. - **Observable information:** Fully observable 2D state. ## Action space - `flick_marble(angle, force)`: 2D vector impulse. ## Playability notes - **Single-player-vs-AI:** High fidelity 2D physics simulation. - **Group games (n>4):** Scales cleanly with multiple agents. - **Physical-skill games:** Thumb-flick mechanics and hole lip geometry mapped to 2D physics collisions. - **What is lost:** Glass marble trading economy and dirt lane grit. ## Implementation hints Standard 2D rigid body circle physics with circular well capture detection.

Download as JSON

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

Download JSON
Cite this page

Lebanese Marbles (Lebanon). (n.d.). Games of Countries. https://gamesofcountries.com/games/lb-lebanon/al-kalal

@misc{gamesofcountries-lb-lebanon-al-kalal,
  title = {Lebanese Marbles (Lebanon)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/lb-lebanon/al-kalal}
}