Formal Specification
Moroccan spinning top (Zarbout) — Formal Specification
Morocco · top-spinning · Confidence: medium
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Trombiya — AI-optimized specification
## General idea
A physical spinning top competition featuring two primary modes: endurance spinning (maximizing angular momentum and stability duration) and circle combat (targeting opponent tops inside a boundary ring with precision trajectory, kinetic impact, and ring-out mechanics).
## Formal model
- **Abstraction taken:** The 3D rotational mechanics, precession, string unwinding velocity, and surface friction are modeled via a 2D physics/energy decay system: , position , and collision momentum transfer .
- **Player/agent count:** agents (, default for 1v1 ring duel).
- **Turn model:** Simultaneous launch in endurance mode; sequential attacking turns in combat mode.
## Formal rules
R1. **Ring Arena & Initial State:**
- Circular arena of radius centered at . Boundary circle .
- In Combat Mode, one agent begins as Target Top positioned at with initial spin energy .
R2. **Launch Parameters & Physics:**
- An agent submits launch action `launch_top(target_x, target_y, force, spin_technique)`:
- Landing coordinates: , with .
- Initial spin energy: .
- Initial state: .
R3. **Collision Resolution:**
- If attacker lands within collision threshold of target top:
- Collision impulse delivers kinetic shock: .
- Both tops lose a fraction of spin energy: .
- If target position reaches , target top suffers a **Ring-Out**.
R4. **Decay and Toppling:**
- Every simulation tick (), each spinning top's energy decays: .
- If , top topples ().
R5. **Scoring and Role Transfer:**
- Attacker earns points if target suffers Ring-Out while attacker remains spinning inside .
- Attacker earns point if target topples first inside .
- If attacker topples first or lands outside , attacker earns points and becomes the new target for the next round.
R6. **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, sudden-death 1v1 endurance round is played: simultaneous launch, top with longest spin duration wins.
- **A player with no legal move:** Launch action is always legal during an active turn.
- **Repetition / cycles:** Impossible — energy decays strictly monotonically toward zero, guaranteeing each round terminates within seconds.
- **Simultaneous claims on the same resource or position:** Collisions resolve instantaneously via conservation of linear and angular momentum.
- **Player elimination mid-round; turn order repair:** Eliminated players in multi-agent mode are dropped from the attack queue; queue advances cyclically among surviving agents.
- **Resource exhaustion:** Finite arena area and discrete energy bounds.
- **Termination guarantee:** Guaranteed by exponential energy dissipation and monotonic round score accumulation.
## State representation
- **Persistent state:** Match scores , active target agent index, current round index.
- **Per-top state:** Position , velocity , spin energy , state .
- **Observable information:** Fully observable 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:** Highly playable: human aims and times power gauge against AI opponent tops with varying defense and offensive attack behaviors.
- **Group games ():** Standard king-of-the-hill / round-robin attack queue.
- **Physical-skill games:** Skill parameter modulates aim variance and spin energy efficiency.
- **What is lost in the adaptation:** The physical tactile pleasure of winding cotton string around carved cedar wood and hearing the sharp hum of the steel pin on pavement.
## Implementation hints
- Implement as a 2D physics simulation with circular rigid body collisions and exponential angular velocity damping.
- First milestone: Implement 1v1 endurance spin mode (two tops decaying in energy), then layer 2D spatial aim and collision displacement.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Moroccan spinning top (Zarbout) (Morocco). (n.d.). Games of Countries. https://gamesofcountries.com/games/ma-morocco/trombiya
@misc{gamesofcountries-ma-morocco-trombiya,
title = {Moroccan spinning top (Zarbout) (Morocco)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ma-morocco/trombiya}
}