Skip to main content
Formal Specification

Libyan Spinning Top — Formal Specification

Libya · top-spinning · Confidence: medium

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Al-Zarbout Libi — AI-optimized specification ## General idea A turn-based dexterity and collision battle game. Agents launch spinning tops into a 2D circle to attack stationary or spinning targets. Direct hits and knock-outs score points, while throw misfires add the attacker's top as a new stationary target. ## Formal model - **Abstraction taken:** Cord-wound ballistic throwing and gyro-stabilization are parameterized by aim accuracy `Accuracy ~ Normal(Aim, sigma)` and spin energy `Energy = f(Power, Skill)`. - **Player/agent count:** `N` agents (default `N = 4`). - **Turn model:** Sequential attack rounds. Maximum 5 complete cycles (20 turns total). ## Formal rules R1. Setup: Circle of radius `R = 1.0m` centered at `(0, 0)`. Target top is positioned at `(0, 0)`. Agents queue in order `0..N-1`. R2. Attack Turn: The active agent chooses `(target_x, target_y)` and `throw_power in [0.5, 1.0]`. R3. Throw Resolution: - Landing point: `(x_land, y_land) = (target_x + Noise_x, target_y + Noise_y)`. - If `norm(x_land, y_land) > R`, top lands `Out of Bounds` (fails). - If `P_spin(Skill, throw_power) < threshold`, top fails to spin (`Dud`) and becomes an additional target at `(x_land, y_land)`. R4. Collision & Displacement: - If landing within collision radius `r_col = 0.15m` of an existing target, momentum transfers. - If target's resulting displacement exceeds `R`, target is `Knocked Out` (attacker earns `+3 points`). - If target remains inside circle, attacker earns `+1 point`. - Attacker top continues spinning with initial energy `E = throw_power * 100`. R5. Energy Decay: At the end of each round, all spinning tops lose `20 energy`. A top reaching `0 energy` becomes a stationary target. R6. [gap-fill] Win Condition: The agent with the highest score after 5 full cycles, or the first to reach 10 points, wins. ## Edge cases - Tie at the end condition: [gap-fill] If scores are tied after 5 cycles, a sudden-death single endurance spin round resolves the tie. - A player with no legal move: Not applicable; throw action is always available. - Repetition / cycles: Bounded strictly by the 5-cycle maximum limit. - Simultaneous claims on the same resource or position: Sequential throw order prevents simultaneous collisions. - Player elimination mid-round; turn order repair: Knocked-out targets are removed from the board without altering queue rotation order. - Resource exhaustion: Monotonically decaying cycle counter. - Termination guarantee: Enforced by the 5-cycle hard limit. ## State representation - Persistent state: `scores: Array[N][int]`, `active_targets: List[TopState]`, `cycle_num: int in [1..5]`. - Ephemeral state: `active_throw: (float, float, float)`. - Observability: Complete, perfect public information. ## Action space - `launch_top(target_x, target_y, power)` where `target_x, target_y in [-1.0, 1.0]`, `power in [0.5, 1.0]`. ## Playability notes - Single-player-vs-AI: Engine-ready arcade-style physics aiming game against heuristic AI bots. - Group games (n>4): Extends naturally to `N` players in rotation. - Physical-skill games: Dynamic spin-energy transfer modeled via clear mathematical functions. - What is lost: The sound of the sharp iron nail biting into hard Libyan clay. ## Implementation hints 2D circle collision state machine. First milestone: implement circular boundary check and Euclidean distance collision detection before tuning stochastic noise distributions.

Download as JSON

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

Download JSON
Cite this page

Libyan Spinning Top (Libya). (n.d.). Games of Countries. https://gamesofcountries.com/games/ly-libya/al-zarbout-libya

@misc{gamesofcountries-ly-libya-al-zarbout-libya,
  title = {Libyan Spinning Top (Libya)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/ly-libya/al-zarbout-libya}
}