Formal Specification
Marbles (Al-Bananir) — Formal Specification
Jordan · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 1
# Al-Qulal — AI-optimized specification
## General idea
A traditional marble-shooting game. In the AI model, the physical acts of finger-flicking and aiming are replaced by a stochastic shooter module incorporating distance, angle, and player skill. This preserves the mechanics of shooting into a pit (*Al-Jura*), gaining extra turns upon successful entry, and striking opponent marbles to win them.
## Formal model
- **Abstraction taken:** Hand-eye precision, finger strength, and terrain friction are collapsed into a vector-based aiming action and a probability resolver.
- **Player/agent count:** 2 to 6 players.
- **Turn model:** Sequential, with the active player retaining their turn upon successful scoring shots.
## Formal rules
R1. **Setup:**
1.1. The playing surface is modeled as a 2D plane with a circular pit (*Al-Jura*) at the origin (0,0) of radius 4 cm.
1.2. Each player places their marble (*Benor*) at a starting line 2.5 meters from the origin.
1.3. Players start with a pool of 5 marbles.
R2. **The Turn and Shooting:**
2.1. On their turn, the active player chooses a target: either the Pit (0,0) or an opponent's marble (2D coordinate).
2.2. They execute a shot, resolved stochastically:
- Input: target position, aiming force.
- Output: new 2D coordinate of the player's marble.
2.3. **Scoring in Pit:** If the player's marble stops inside the Pit, they score a "pit-in" and are granted an immediate extra shot.
2.4. **Striking Opponent:** If the player's marble collides with an opponent's marble, the opponent's marble is "struck" (captured). The active player receives that marble and gains an extra shot.
2.5. If the shot misses both the Pit and all opponent marbles, the player's marble remains at its new 2D resting coordinate, and the turn passes to the next player.
R3. **Winning:**
3.1. A player is eliminated if their marble is struck and they have no marbles remaining in their pool to enter.
3.2. [gap-fill] The game ends when only one player remains with active marbles, or after a maximum of 50 turns, in which case the player who has captured the most opponent marbles wins.
## Edge cases
- **Tie at the end condition:** If there is a tie in captures at the 50-turn limit, the player with their marble closest to the Pit wins.
- **A player with no legal move:** Not applicable; a shot can always be taken from the marble's current position.
- **Repetition / cycles:** Bounded by R3.2 (50-turn hard limit).
- **Simultaneous claims on the same resource:** Not applicable; sequential turns.
- **Player elimination mid-round:** Handled by R3.1; eliminated players are removed from the rotation queue.
- **Resource exhaustion:** Bounded by the marble pools.
- **Termination guarantee:** Guaranteed by the 50-turn limit and the elimination of players as their marbles are captured.
## State representation
- **Persistent state:** 2D positions of all active marbles, marble pool count per player, scores (captured marbles) per player, current turn index, active queue.
- **Per-turn ephemeral state:** Chosen target coordinate, shooting force, shot output resting position.
- **Observable information:** Fully observed.
## Action space
- `shoot_marble(target_x, target_y, force)`: Shoots the marble toward a target coordinate with a specified force parameter.
## Playability notes
- **Single-player-vs-AI:** Natural; the user selects target coordinates and force, competing against AI agents using basic geometric pathfinding algorithms.
- **Group games:** Generalizes cleanly up to 6 players.
- **What is lost in the adaptation:** The physical tactile feedback of flicking glass spheres and reading irregular dirt terrain is fully lost.
## Implementation hints
Use simple 2D geometry to calculate distances between the resting coordinate and targets. If distance < target_radius, trigger collision and capture. Implement the continuous 2D position updates and rotation logic as the first milestone.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Marbles (Al-Bananir) (Jordan). (n.d.). Games of Countries. https://gamesofcountries.com/games/jo-jordan/al-qulal
@misc{gamesofcountries-jo-jordan-al-qulal,
title = {Marbles (Al-Bananir) (Jordan)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/jo-jordan/al-qulal}
}