Skip to main content
Formal Specification

Qulul (Marbles) — Formal Specification

Palestine · dexterity-small · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Al-Qulul — AI-optimized specification ## General idea A traditional marble flicking and hole navigation game (*Joura*). Players flick their primary shooter marble (*Ras*) through a sequence of target ground holes in designated order, earning "Hunter" (*Sayyad*) status, after which striking opponent marbles captures them from the field. ## Formal model - **Abstraction taken:** Ground surface modeled as a 2D continuous or fine-grid plane containing K=3 ordered hole coordinates H1,H2,H3. Marble flicks are modeled as vector trajectories with stochastic deviation. - **Player/agent count:** 2 to 6 individual players. - **Turn model:** Sequential turns; successful hole entry or marble hit awards an extra flick. ## Formal rules R1. **Initial setup:** Holes H1,H2,H3 dug in a straight line at intervals D=2m. Players flick from baseline to establish starting order (closest to H1 goes first). R2. **Course completion:** Each player must flick their marble into the holes in exact sequence: H1→H2→H3→H2→H1 - Landing inside the designated hole grants an immediate bonus flick. R3. **Promotion to Hunter:** Upon completing the full hole circuit, the player's marble becomes a *Hunter* (*Sayyad*). R4. **Elimination & capture:** - A *Hunter* may target opponent marbles. - If a *Hunter* strikes an opponent marble: - Opponent marble is eliminated and captured (claimed as prize) [gap-fill]. - *Hunter* receives a bonus turn. R5. **Victory:** The player who captures all opponent marbles, or has the highest marble capture count after all opponents are eliminated, wins the match. R6. [gap-fill] Boundary fault:** Flicking outside arena boundary resets marble to point of exit and ends turn. ## Edge cases - **Tie at the end condition:** Highest count of marbles captured. - **A player with no legal move:** Player always has the option to flick toward a target. - **Repetition / cycles:** Progress through hole sequence is tracked monotonically. - **Simultaneous claims:** Strictly turn-based resolution. - **Player elimination mid-round:** Eliminated players surrender their marble and exit the match. - **Resource exhaustion:** Finite marbles in play. - **Termination guarantee:** Provable termination as each player elimination strictly decreases active agents. ## State representation - **Persistent state:** `hole_coordinates: List[(float, float)]`, `marbles_captured: Dict[PlayerID, int]`. - **Ephemeral state:** `positions: Dict[PlayerID, (float, float)]`, `circuit_stage: Dict[PlayerID, int]`, `is_hunter: Dict[PlayerID, bool]`, `active_player: PlayerID`. - **Observable information:** Fully observable 2D state. ## Action space - `flick_marble(angle, force)`: Physics-based impulse with stochastic deviation. ## Playability notes - **Single-player-vs-AI:** Direct implementation as a precision physics flicking game. - **Group games (n>4):** Scales naturally with multiple players. - **Physical-skill games:** Thumb-flick mechanics mapped to angle/power vectors with Gaussian noise. - **What is lost:** Dirt terrain friction variations, glass marble chipping, and tactile thumb tension. ## Implementation hints Lightweight 2D physics or discrete raycast collision engine.

Download as JSON

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

Download JSON
Cite this page

Qulul (Marbles) (Palestine). (n.d.). Games of Countries. https://gamesofcountries.com/games/ps-palestine/qulul

@misc{gamesofcountries-ps-palestine-qulul,
  title = {Qulul (Marbles) (Palestine)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/ps-palestine/qulul}
}