Formal Specification
Al-Misra — Formal Specification
Iraq · dexterity-small · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Al-Misra' — AI-optimized specification
## General idea
A traditional Iraqi spinning top game played in a ring arena. Players wind a string around a metal-tipped hardwood conical top (*Misra'*), fling it into a circular boundary, and compete to achieve the longest spin duration or strike and knock opponent tops out of the ring.
## Formal model
- **Abstraction taken:** Ring arena modeled as a 2D circle with radius . Spin dynamics modeled as an initial angular velocity decaying monotonically over time , with collision impulse between colliding tops.
- **Player/agent count:** 2 to 6 players.
- **Turn model:** Simultaneous top launches per round.
## Formal rules
R1. **Simultaneous launch:** All players throw their tops into the ring simultaneously:
- Landing location: . If outside ring, launch is an immediate fault (0 duration).
- Initial spin energy: .
R2. **Duration competition:**
- Spin energy decays each tick: .
- A top stops spinning when .
- The player whose top maintains positive spin energy longest wins the duration category (scores 1 point).
R3. **Ring clash (Battle ring):**
- If top collides with top while inside the ring:
- Collision imparts physical impulse .
- If top is knocked outside radius or falls over due to tilt instability, top is eliminated.
- Top scores 2 points for knocking an opponent out [gap-fill].
R4. **Victory condition:** First player to reach 5 points wins the match.
R5. [gap-fill] Round limit:** Maximum 10 rounds per match.
## Edge cases
- **Tie at the end condition:** Highest points; sudden death round if tied.
- **A player with no legal move:** All players execute launch.
- **Repetition / cycles:** Bounded by 10-round ceiling.
- **Simultaneous claims:** Physics collision order resolves knockouts.
- **Player elimination mid-round:** Eliminated tops stop spinning.
- **Resource exhaustion:** 1 top per player.
- **Termination guarantee:** Provably terminates via finite spin decay and 10-round cap.
## State representation
- **Persistent state:** `scores: Dict[PlayerID, int]`, `rounds_played: int`.
- **Ephemeral state:** `top_positions: Dict[PlayerID, (float, float)]`, `spin_energy: Dict[PlayerID, float]`, `is_active: Dict[PlayerID, bool]`.
- **Observable information:** Fully observable state.
## Action space
- `launch_top(target_x, target_y, force, spin_angle)`: Continuous launch parameters.
## Playability notes
- **Single-player-vs-AI:** Operates as a physics-based arena combat simulator (like Beyblade / spinning tops).
- **Group games (n>4):** Native simultaneous free-for-all clash.
- **Physical-skill games:** String-wrapping tension and wrist flick mapped to force/energy parameters.
- **What is lost:** Acoustic humming sounds (*Al-Wannan* whining vs *Al-Na'oor* rattling) and carved wood aroma.
## Implementation hints
Lightweight 2D physics engine tracking gyroscopic decay and elastic disk collisions.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Al-Misra (Iraq). (n.d.). Games of Countries. https://gamesofcountries.com/games/iq-iraq/al-misra
@misc{gamesofcountries-iq-iraq-al-misra,
title = {Al-Misra (Iraq)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/iq-iraq/al-misra}
}