Formal Specification
Qulul (Marbles) — Formal Specification
Palestine · dexterity-small · Confidence: low
← Back to game pageImplementation 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 ordered hole coordinates . 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 dug in a straight line at intervals . Players flick from baseline to establish starting order (closest to goes first).
R2. **Course completion:** Each player must flick their marble into the holes in exact sequence:
- 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 JSONCite 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}
}