Skip to main content
Formal Specification

Omani Marble Circle Target Game — Formal Specification

Oman · dexterity-throw · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Al-Yousha — AI-optimized specification ## General idea A precision marble circle-targeting game. Agents flick a weighted master shooter projectile from a baseline toward a central cluster of target marbles, balancing aim and shot power to knock targets outside the ring perimeter while avoiding having the shooter trapped inside the ring. ## Formal model - **Abstraction taken:** The 1.0m ring is modeled as a 2D circular boundary `R = 0.5m` centered at `(0, 0)`. Target marbles occupy discrete 2D positions. Shooter trajectories are evaluated via 2D physics and impulse collisions. - **Player/agent count:** `N` agents (`2 <= N <= 8`). - **Turn model:** Sequential turn-based rounds. ## Formal rules R1. Setup: - Ring radius `R = 0.5m`. - Total staked marbles `M = N * k` (`k = 2` default) distributed near `(0, 0)`. - Shooter baseline at `y = -3.0m`. R2. Shooting Action: - Agent executes `shoot_marble(aim_angle, power)`: - Shot trajectory: `vel_shooter = power * max_speed * direction(aim_angle) + noise(aim_skill)`. [gap-fill] R3. Collision Resolution: - Shooter interacts elastically with target marbles: - Any target marble propelled to `dist(pos, (0, 0)) > 0.5m` is knocked out: Agent claims +1 marble/point. - Shooter position resolves: - If shooter exits ring or captures at least 1 marble, agent continues or retains advantage. R4. Win Condition: - Game terminates when all `M` marbles are knocked out. Agent with most claimed marbles wins. ## Edge cases - **Tie at the end condition:** Sudden-death 1-marble target shoot tiebreak. - **A player with no legal move:** Shoot action always valid. - **Repetition / cycles:** Monotonic target marble clearing guarantees termination. - **Simultaneous claims:** Sequential turns prevent concurrent shots. - **Player elimination mid-round:** Players do not get eliminated. - **Resource exhaustion:** Finite `M` target marbles. - **Termination guarantee:** Guaranteed by finite marble count. ## State representation - **Persistent state:** - `scores: Array[N] of int`. - `active_player: int`. - **Ephemeral round state:** - `target_positions: Dict[int, Vector2D]`. - `shooter_pos: Vector2D`. - **Information set:** Perfect information, fully observable. ## Action space - `shoot_marble(angle: float, power: float)`: Precision flick. ## Playability notes - **Single-player-vs-AI:** Highly playable precision puzzle game. - **Group games:** Scales naturally for 2 to 8 players. - **Physical-skill model:** Thumb flick velocity and angle are modeled via 2D elastic collisions. - **What is lost:** Tactile glass texture and sandy friction. ## Implementation hints Standard 2D rigid-body circle collision physics with perimeter damping.

Download as JSON

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

Download JSON
Cite this page

Omani Marble Circle Target Game (Oman). (n.d.). Games of Countries. https://gamesofcountries.com/games/om-oman/al-yousha

@misc{gamesofcountries-om-oman-al-yousha,
  title = {Omani Marble Circle Target Game (Oman)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/om-oman/al-yousha}
}