Skip to main content
Formal Specification

Maltese Spinning Top — Formal Specification

Malta · top-spinning · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 2
# Iż-Żugraga — AI-optimized specification ## General idea A spinning top contest modeling both ring ejection battles and spin endurance. Agents launch tops with parameterized velocity and spin vectors into a bounded 2D circle, attempting to knock opponent tops across the perimeter line while maintaining their own spin equilibrium. ## Formal model - **Abstraction taken:** The 3D rotational mechanics and friction dynamics of the wooden top (*żugraga*) on pavement are abstracted into 2D circle physics with an angular momentum decay scalar `Spin_RPM(t) = RPM_0 * exp(-lambda * t)`. Collisions are modeled via 2D elastic impulse resolution. - **Player/agent count:** 2 to 8 players. - **Turn model:** Round-based. Within each round, players take sequential aim-and-launch actions into the ring. ## Formal rules R1. Setup: A circle of radius `R_ring = 0.75` meters is centered at `(0, 0)`. Target top starts stationary at `(0, 0)`. R2. Round execution: R2.1. On their turn, an active agent inputs a launch vector `(target_x, target_y)` and launch power `W in [0, 1]`. R2.2. The resolver samples landing coordinate `pos_land ~ Normal(target, sigma(skill))` and initial spin `RPM_0 ~ Normal(3000 * W, 200)`. R2.3. If `pos_land` falls outside `R_ring`, the launch is a foul, scoring 0 points. R2.4. If `pos_land` collides with a top inside the ring, momentum transfer is resolved: target top acquires velocity `v_target`, displacing it. R2.5. If the target top's position exceeds `R_ring` (`||pos_target|| > R_ring`), the active player scores 1 point (*ejection success*). R2.6. If the active top ceases spinning (`Spin_RPM <= 0`) while remaining inside `R_ring`, it becomes a stationary target for subsequent players. R3. [gap-fill] Scoring & victory: A match consists of 5 rounds. The player with the most cumulative ejection points and spin victories wins the match. R4. [gap-fill] Turn order rotation: The player with the lowest score launches first in the subsequent round. ## Edge cases - Tie at the end condition: If top players are tied after 5 rounds, a 1-round simultaneous spin endurance trial determines the winner. - A player with no legal move: Not applicable — launch actions are always available. - Repetition / cycles: Bounded by the fixed 5-round limit (R3). - Simultaneous claims on the same resource or position: In sequential mode, launches occur one at a time. In simultaneous endurance mode, collisions between spinning tops are resolved in order of contact timestamp. - Player elimination mid-round: If an agent disconnects, their top is removed from the ring and turn order continues. - Resource exhaustion: Not applicable — tops are retrieved after each round. - Termination guarantee: Guaranteed by the finite round count and positive friction decay `lambda > 0` which forces all spin to zero in finite time. ## State representation - Persistent state: `match_round` (int 1..5), `scores` (map of player_id -> int), `turn_order` (list of player_ids). - Per-round ephemeral state: `active_tops` (list of entities with `pos (x,y)`, `velocity (vx,vy)`, `spin_rpm (float)`, `is_spinning (bool)`). - Observable information: Fully observable by all agents. ## Action space - `launch_top(target_x, target_y, power)`: Specify launch aim coordinates within the ring and release power scalar. ## Playability notes - Single-player-vs-AI: Natural — human player competes against AI in precision targeting and collision physics. - Group games (n>4): Ring battle scales cleanly with sequential turns. - Physical-skill games: String winding tension and wrist snap abstracted into `power` and `sigma(skill)`. - What is lost: The tactile mastery of cord tension and the kinetic spectacle of wooden tops buzzing on pavement. ## Implementation hints Standard 2D rigid-body circle physics simulation with rotational friction dampening. Suggested milestone: Verify R2.4–R2.5 ejection boundary checks with a single stationary target before adding multi-top collisions.

Download as JSON

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

Download JSON
Cite this page

Maltese Spinning Top (Malta). (n.d.). Games of Countries. https://gamesofcountries.com/games/mt-malta/iz-zugraga

@misc{gamesofcountries-mt-malta-iz-zugraga,
  title = {Maltese Spinning Top (Malta)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/mt-malta/iz-zugraga}
}