Skip to main content
Formal Specification

Mauritanian desert spinning top — Formal Specification

Mauritania · top-spinning · Confidence: medium

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Zarbout Mauritani — AI-optimized specification ## General idea A desert spinning top physics game featuring endurance spinning and combat ring battles. Players time launches and target trajectory into a circular sand ring (R=0.75m), optimizing angular velocity and momentum transfer to achieve ring-outs against opponent tops. ## Formal model - **Abstraction taken:** The 3D spinning dynamics and granular sand friction are modeled as a 2D physics state: position (X,Y), linear velocity (Vx,Vy), and exponential spin energy decay: Espin(t)=E0⋅e−λsandt. Rigid circular collisions model impact forces and ring displacements. - **Player/agent count:** N players (N∈[2,6], default N=2). - **Turn model:** Simultaneous launch in endurance mode; sequential attacking turns in combat mode. ## Formal rules R1. **Sand Arena & Setup:** - Sand ring of radius R=0.75m centered at (0,0). - In combat mode, Target Top starts at (0,0) with initial spin energy Etarget=100. R2. **Launch Action:** - Active agent executes `launch_top(target_x, target_y, force, spin_angle)`: - Landing coordinates: (X0,Y0)=(xtarget,ytarget)+𝛜, with 𝛜∼𝒩(0,σaim2). - Initial spin energy: E0=force⋅100. R3. **Collision & Ring-Out Resolution:** - If attacker lands within collision distance d≤0.12m of target top: - Momentum impulse displaces target top: Δ𝐯target∝force⋅𝐫ˆ. - Both tops lose a portion of spin energy (E←E⋅0.8). - If target position exceeds boundary (X2+Y2>R2), target suffers **Ring-Out**. R4. **Decay and Scoring:** - In sand, spin energy decays each tick: E(t+Δt)=E(t)−λsand⋅Δt. - When E≤0, top topples (`status = toppled`). - Scoring: - Attacker scores +2 points if target suffers Ring-Out while attacker remains spinning inside R. - Attacker scores +1 point if target topples first inside R. - If attacker topples first or lands outside R, attacker earns 0 points and becomes the target for the next round. R5. **Victory Condition:** - [gap-fill] The first player to reach 5 points wins the match. ## Edge cases - **Tie at the end condition:** If both players reach 5 points on the same round, a sudden-death simultaneous endurance spin determines the winner. - **A player with no legal move:** Launch action is always legal during one's turn. - **Repetition / cycles:** Impossible — energy E(t) decays strictly monotonically toward zero, guaranteeing each round ends in ≤25 seconds. - **Simultaneous claims on the same resource or position:** Collisions resolve instantaneously via elastic momentum transfer. - **Player elimination mid-round; turn order repair:** Handled via standard round-robin rotation. - **Resource exhaustion:** Bounded arena area and discrete energy bounds. - **Termination guarantee:** Guaranteed by exponential sand friction dissipation λsand>0. ## State representation - **Persistent state:** Scores (S1,…,SN), current target agent ID, round index. - **Per-top state:** Position (Xi,Yi), velocity (Vxi,Vyi), spin energy Ei, state ∈{spinning,toppled,ring_out}. - **Observable information:** Fully observable 2D state. ## Action space - `launch_top(target_x, target_y, force, spin_angle)`: - `target_x, target_y` ∈[−0.9,0.9]m. - `force` ∈(0,1.0]. - `spin_angle` ∈[0,2π). ## Playability notes - **Single-player-vs-AI:** Engaging physics contest: human controls power and aim against AI tops with distinct weight and spin characteristics. - **Group games (N>2):** Scales cleanly to multi-agent tournament brackets. - **Physical-skill games:** Winding tightness and wrist snap abstracted into force parameter and aim variance. - **What is lost in the adaptation:** The smell of shaved acacia wood and watching the top carve smooth spirals in soft dune sand. ## Implementation hints - Implement circular bounding-box collision detection with coefficient of restitution e≈0.6 on sand. - First milestone: Implement 1v1 endurance spin test verifying energy decay and 5-point victory triggers.

Download as JSON

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

Download JSON
Cite this page

Mauritanian desert spinning top (Mauritania). (n.d.). Games of Countries. https://gamesofcountries.com/games/mr-mauritania/zarbout

@misc{gamesofcountries-mr-mauritania-zarbout,
  title = {Mauritanian desert spinning top (Mauritania)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/mr-mauritania/zarbout}
}