Formal Specification
Mauritanian desert spinning top — Formal Specification
Mauritania · top-spinning · Confidence: medium
← Back to game pageImplementation 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 (), 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 , linear velocity , and exponential spin energy decay: . Rigid circular collisions model impact forces and ring displacements.
- **Player/agent count:** players (, default ).
- **Turn model:** Simultaneous launch in endurance mode; sequential attacking turns in combat mode.
## Formal rules
R1. **Sand Arena & Setup:**
- Sand ring of radius centered at .
- In combat mode, Target Top starts at with initial spin energy .
R2. **Launch Action:**
- Active agent executes `launch_top(target_x, target_y, force, spin_angle)`:
- Landing coordinates: , with .
- Initial spin energy: .
R3. **Collision & Ring-Out Resolution:**
- If attacker lands within collision distance of target top:
- Momentum impulse displaces target top: .
- Both tops lose a portion of spin energy ().
- If target position exceeds boundary (), target suffers **Ring-Out**.
R4. **Decay and Scoring:**
- In sand, spin energy decays each tick: .
- When , top topples (`status = toppled`).
- Scoring:
- Attacker scores points if target suffers Ring-Out while attacker remains spinning inside .
- Attacker scores point if target topples first inside .
- If attacker topples first or lands outside , 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 decays strictly monotonically toward zero, guaranteeing each round ends in 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 .
## State representation
- **Persistent state:** Scores , current target agent ID, round index.
- **Per-top state:** Position , velocity , spin energy , state .
- **Observable information:** Fully observable 2D state.
## Action space
- `launch_top(target_x, target_y, force, spin_angle)`:
- `target_x, target_y` .
- `force` .
- `spin_angle` .
## 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 ():** 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 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 JSONCite 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}
}