Skip to main content
Formal Specification

The Bee (Egyptian Spinning Top) — Formal Specification

Egypt · top-spinning · Confidence: medium

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Al-Nahlah — AI-optimized specification ## General idea A physics-proxy competitive top-spinning game. Agents allocate launch force, release angle, and target coordinates inside a circular arena. Launch parameters generate rotational RPM, trajectory drift, and collision impulse against opponent tops to maximize spin duration or knock targets out of the ring. ## Formal model - **Abstraction taken:** Continuous physical dynamics (gyroscopic precession, aerodynamic drag, friction, impact coefficient) are discretized into a 2D position vector 𝐩∈ℝ2, angular velocity ω∈ℝ+, and stability metric S∈[0,1]. - **Player/agent count:** 2 agents in a direct 1v1 battle arena (generalizable to N agents). - **Turn model:** Simultaneous launch in endurance mode; sequential launch in circle knockout mode. ## Formal rules R1. The arena is a circle of radius R=1.0 m centered at (0,0). R2. Launch Action: Agent chooses (𝐩target,F,θ) where 𝐩target∈Arena, F∈[0,100] (force), θ∈[0,90∘] (angle). R3. Initial State Generation: - Actual landing position: 𝐩0=𝐩target+𝛅 where 𝛅∼𝒩(0,σaim2). - Initial RPM: ω0=50×F×sin⁡(θ)×(1−error). - Initial Stability: S0=cos⁡(θ)×(1−wobble). - If ω0<500, top fails to spin (`DEAD_LAUNCH`). R4. Discrete Time Decay (per tick Δt): - ωt+1=ωt−μfriction×Δt. - St+1=St−kωt×Δt. - Position drift: 𝐩t+1=𝐩t+𝐯precession×Δt. R5. Collision Resolution: - If distance ‖𝐩A−𝐩B‖<rA+rB: - Momentum transfer: Δ𝐯 applied proportional to relative velocities and masses. - Stability shock: S reduced by impact force. - If top leaves arena (‖𝐩‖>R), it is `OUT_OF_BOUNDS`. R6. Spin termination: When ωt≤0 or St≤0, the top falls (`TOPPLED`). R7. [gap-fill] Scoring: In Endurance mode, points equal total ticks survived. In Battle mode, knocking opponent out of bounds awards +10 points; splitting/toppling opponent awards +15 points. R8. [gap-fill] Match Termination: Game consists of 5 rounds. Highest cumulative score wins. ## Edge cases - Tie at the end condition: If cumulative scores are tied at round 5, an additional sudden-death spin endurance round is conducted. - A player with no legal move: Action space is continuous; default safe launch parameters are always available. - Repetition / cycles: Spin duration strictly decays monotonically to zero per R4; infinite spinning is physically impossible. - Simultaneous claims on the same resource or position: Physical collision resolver (R5) determines resulting scatter trajectories. - Player elimination mid-round; turn order repair: Toppled or out-of-bounds tops are frozen at their terminal state until round end. - Resource exhaustion (pieces, tokens, space, time): Rounds strictly expire when all tops topple. - Termination guarantee: Monotonic angular velocity decay (ω→0) guarantees finite round termination. ## State representation - Persistent state: `match_scores`: `{AGENT_A: int, AGENT_B: int}`, `round_number: int`. - Per-round state: - `top_states`: `{AGENT_ID: {pos: (x,y), omega: float, stability: float, status: ACTIVE | TOPPLED | OUT}}`. - `tick_counter`: integer. - Observable information: Fully observable by both agents. ## Action space - `launch(x_target, y_target, force, angle)`: parameter vector in ℝ4. ## Playability notes - Single-player-vs-AI: Engine-ready; play as human vs AI in target striking or spin endurance challenges. - Group games (n>4): Generalizes to free-for-all battle royale with N tops in the ring. - Physical-skill games: String winding tension and arm snap are captured in force, angle, and aim variance parameters. - What is lost in adaptation: The tactile feel of string pull and aerodynamic whistling acoustics are abstracted. ## Implementation hints Standard 2D rigid-body Euler integration physics model. First milestone: implement single-top spin decay (R4) and verify that tops topple in 10-30 simulated seconds before implementing inter-top collision physics.

Download as JSON

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

Download JSON
Cite this page

The Bee (Egyptian Spinning Top) (Egypt). (n.d.). Games of Countries. https://gamesofcountries.com/games/eg-egypt/el-nahlah

@misc{gamesofcountries-eg-egypt-el-nahlah,
  title = {The Bee (Egyptian Spinning Top) (Egypt)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/eg-egypt/el-nahlah}
}