Formal Specification
Syrian Marbles — Formal Specification
Syria · dexterity-small · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 1
# Al-Dahl — AI-optimized specification
## General idea
A turn-based 2D spatial targeting game where agents maneuver shooter marbles on a continuous arena containing a target hole. Entering the hole activates "hunter status," unlocking the capability to shoot at and eliminate opposing marbles. A physics/skill function resolves shot accuracy and collision dynamics.
## Formal model
- **Abstraction taken:** 2D continuous bounding arena with a target circle of radius at origin . Physical flicking parameterized as: .
- **Player/agent count:** 2 to 8 agents (modeled as 2-agent zero-sum elimination).
- **Turn model:** Sequential turn rotation. Landing in the hole or hitting an opposing target marble grants an immediate consecutive shot.
## Formal rules
R1. Setup: Each agent begins with shooter position at starting baseline . Status .
R2. On agent 's turn, agent selects shot vector .
R3. Outcome simulation:
- Shooter moves along with friction until stopping at .
- If trajectory passes through or ends within the hole area (), , and the marble is placed at . Agent receives a bonus shot.
R4. Target hitting:
- If and the marble collides with opponent marble at , opponent is eliminated (). Agent receives a bonus shot.
- If , colliding with an opponent merely alters positions elastically without elimination or bonus turn.
R5. Missed shot: If no hole entry and no valid hit occurs, turn passes to the next active agent.
R6. Win condition: The last surviving non-eliminated agent wins the match.
## Edge cases
- **Tie at the end condition:** Not applicable; elimination is strictly sequential and a single surviving agent triggers victory.
- **A player with no legal move:** Not applicable; an aim vector can always be selected.
- **Repetition / cycles:** [gap-fill] Cycle breaker: If 30 consecutive turns elapse where neither player achieves a hole entry or hit, both marbles are reset to the baseline and the next player to enter the hole wins immediately.
- **Simultaneous claims on the same resource or position:** Physics resolver handles collisions sequentially along time parameter .
- **Player elimination mid-round; turn order repair:** Eliminated agents are removed from the active rotation queue; index shifts to `next_player = (current + 1) % len(active)`.
- **Resource exhaustion:** Not applicable; marbles are durable tokens.
- **Termination guarantee:** Guaranteed by finite state bounds, absorbing elimination states, and the 30-turn non-progress cycle breaker.
## State representation
- Persistent state:
- `positions`: array of 2D coordinates .
- `status`: array of states .
- `active_agent`: index of current player.
- `turn_without_progress`: integer counter.
- Ephemeral state: `shot_vector` chosen for current turn.
- Observable information: Fully observable 2D state.
## Action space
- `shoot(angle, power)`: Continuous control tuple .
- Discretized mode: `shoot_target(target_type, aim_bias)` where target_type .
## Playability notes
- Single-player-vs-AI: Natural; AI calculates optimal aim vector balancing risk of missing versus reward of entering hole or hitting opponent.
- Group games (n>4): Generalizes to agents with round-robin turn order and multi-agent elimination.
- Physical-skill games: Motor precision parameterized via Gaussian noise variance scaling inversely with agent skill.
- What is lost in the adaptation: Surface dirt irregularities, tactile thumb-flicking friction, and marble collection trading.
## Implementation hints
- Implement a 2D circle-circle collision detector with simple linear drag.
- Suggested first milestone: Implement deterministic 2D kinematics with hole-entry state transitions before tuning AI targeting heuristics.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Syrian Marbles (Syria). (n.d.). Games of Countries. https://gamesofcountries.com/games/sy-syria/al-dahl
@misc{gamesofcountries-sy-syria-al-dahl,
title = {Syrian Marbles (Syria)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/sy-syria/al-dahl}
}