Formal Specification
Spinning Top — Formal Specification
Lithuania · top-spinning · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 7
# Vilkelio sukimas — AI-optimized specification
## General idea
Vilkelio sukimas is a traditional Lithuanian wooden top-spinning contest. Agents compete in two distinct modes: an Endurance Contest (maximizing rotational spin duration before gyroscopic toppling) and an Arena Knockout Duel (launching spinning tops into a 1-meter circular arena to physically impact, destabilize, and eject opponent tops). The match is structured as a race to accumulate 5 victory points.
## Formal model
- **Abstraction taken:** Probabilistic-proxy. Continuous 3D rigid-body rotational dynamics (Euler angles, precession, nutation, aerodynamic drag, and tip-ground friction) are abstracted into 2D planar coordinates , angular velocity , and a stability threshold below which gyroscopic collapse occurs [gap-fill]. Inter-top collisions resolve via 2D impulse and momentum exchange with angular velocity degradation [gap-fill].
- **Player/agent count:** agents ().
- **Turn model:** Mode A is simultaneous launch; Mode B uses sequential targeting turns per round.
## Formal rules
R1. Setup and Contest Mode:
- Match target is fixed at points.
- The active mode is set to Mode B (Arena Knockout Duel) by default [gap-fill].
- Arena: Circular ring of radius (diameter ) centered at .
R2. Top State Variables:
- Each top possesses position , translational velocity , angular velocity , and active status .
- Angular decay: , with collapse occurring when [gap-fill].
R3. Mode A: Endurance Contest (Kas ilgiau sukasi):
- All agents submit launch parameters simultaneously.
- Initial angular velocity .
- Total spin duration is computed from decay ODE.
- The agent with the maximum spin duration is awarded point.
R4. Mode B: Arena Knockout Duel (Vilkiukų kova):
- Turn order is determined by lot.
- First agent launches top into center zone ().
- Subsequent agents sequentially launch their tops aiming at existing spinning tops with chosen trajectory .
- Collision Resolution: When two spinning tops collide at distance :
- Translational momentum resolves via elastic collision: .
- Angular shock penalty: Both tops lose angular velocity: [gap-fill].
- Elimination Triggers: A top is eliminated from the round if:
- It travels outside the arena boundary: .
- Its angular velocity drops below critical: (topples).
- It fails to land point-down inside the ring on launch [gap-fill].
- Scoring: The owner of an incoming top that directly causes an opponent top to topple or exit scores point. The last top remaining upright inside the circle earns bonus point.
R5. Match Termination:
- The first agent to accumulate points wins the match.
## Edge cases
- Tie at the end condition: If two tops topple or exit the ring on the exact same tick in Mode B, no bonus point is awarded; tied leaders at 5 points conduct a 1v1 Mode A endurance spin-off [gap-fill].
- A player with no legal move: Not applicable — launch parameters (power, aim coordinate) are always submittable.
- Repetition / cycles (and the loop-breaking rule): Inactive spinning is impossible because angular velocity decays strictly monotonically to zero under friction, ensuring every round terminates in .
- Simultaneous claims on the same resource or position: Physical top bodies resolve via hard-sphere elastic repulsion.
- Player elimination mid-round; turn order repair: A toppled/ejected top becomes inactive for the remainder of that round; turn order skips inactive players until the next round reset.
- Resource exhaustion (pieces, tokens, space, time): Tops are persistent and reusable; points accumulate monotonically.
- Termination guarantee: Provably terminates due to monotonic angular friction decay in rigid-body physics and the finite 5-point match target.
## State representation
- Persistent state: Agent count , scoreboard array , active contest mode, round index.
- Per-turn ephemeral state: Active tops state array , arena boundary, collision event log, active turn pointer.
- Observable information: Fully observable — all top coordinates, spin velocities, and match scores are public.
## Action space
- `launch_endurance(torque, release_angle)`: Execute pure vertical spin launch (Mode A).
- `launch_knockout(target_x, target_y, torque, trajectory_angle)`: Aimed tactical launch into arena (Mode B).
## Playability notes
- Single-player-vs-AI: Completely natural — player targets AI spinning tops in the arena, balancing landing accuracy against spin power.
- Group games (n>4): Plays seamlessly with 2–8 players; in Mode B, launching later in the turn order offers tactical advantages (richer target pool), which is balanced by rotating starting order each round.
- Physical-skill games: The tactile wrist flick, string winding tension, and whip lash mechanics are modeled as launch parameter distributions.
- What is lost: The mesmerizing visual hum and wobble of hand-carved wood grain, the sharp clacking sound of hardwood collisions, and whip cord coordination are converted into mathematical vectors.
## Implementation hints
Requires a 2D physics simulation with angular velocity decay ODEs and circle collision detection.
First milestone: Build the Mode A spin decay calculator, then implement 2D circle boundary containment and collision impulse exchange for Mode B.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Spinning Top (Lithuania). (n.d.). Games of Countries. https://gamesofcountries.com/games/lt-lithuania/vilkelio-sukimas
@misc{gamesofcountries-lt-lithuania-vilkelio-sukimas,
title = {Spinning Top (Lithuania)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/lt-lithuania/vilkelio-sukimas}
}