Skip to main content
Formal Specification

Spinning Top (Vilciņa Griešana / Latgalian Veļceņš) — Formal Specification

Latvia · top-spinning · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 5
# Vilciņš — AI-optimized specification ## General idea A traditional top-spinning endurance and battle contest. Players launch hand-carved wooden tops simultaneously into a circular arena. Points are scored by outlasting opponent tops in spin duration or colliding with and knocking rival tops out of the ring. ## Formal model - **Abstraction taken:** The 3D rotational mechanics, precession, and surface friction of wooden spinning tops are modeled via spin energy E≥0, radial position r≤Rarena, and stochastic collision resolution. - **Player/agent count:** 2 to 6 agents. - **Turn model:** Simultaneous launch rounds followed by physics tick simulation. ## Formal rules R1. Setup: A circular arena of radius Rarena=0.5 m is initialized. Target score Starget=5 points. R2. Launch: Each round, all active agents simultaneously execute `launch_top(power, launch_angle)`. R3. [gap-fill] Initial spin energy is sampled: E0=100⋅power+ϵE, where ϵE∼𝒩(0,5). R4. Top Trajectory and Decay: - Energy decays per tick: E(t+1)=E(t)−(μbase+μdrift⋅r(t)). - Position undergoes Brownian drift r(t+1)=r(t)+δr. - A top is eliminated from the round when E(t)≤0 or r(t)>Rarena. R5. **Collision Resolver:** If distance between two tops d(i,j)<2⋅rtop, a collision occurs [gap-fill]: - Energy transfer: Ei←Ei−ΔE,Ej←Ej−ΔE. - Repulsion impulse displaces both tops away from collision normal. R6. Scoring: - Duration Mode: The last surviving upright top inside the arena scores +1 point. - [gap-fill] Battle Mode: A top that knocks an opponent out of bounds while remaining inside scores +2 points. R7. Match End: The first agent to accumulate Starget=5 points wins the match. ## Edge cases - Tie at the end condition: If two tops exhaust energy on the exact same tick, the round is a draw (0 points awarded to both) [gap-fill]. - A player with no legal move: Not applicable; launch parameters are always available. - Repetition / cycles: Energy decays strictly monotonically (E(t+1)<E(t)), guaranteeing that every round terminates in finite ticks. - Simultaneous claims on the same resource or position: Handled by instantaneous elastic collision resolver. - Player elimination mid-round; turn order repair: In a round, eliminated tops become passive obstacles or are removed [gap-fill]. - Resource exhaustion: Point scores increase monotonically toward target Starget. - Termination guarantee: Monotonically guaranteed by positive energy decay rates per tick. ## State representation - Persistent state: Match scores vector S1,…,SN, round counter. - Per-turn ephemeral state: For each top i: energy Ei, 2D position (xi,yi), velocity vector (vx,i,vy,i), active/fallen status. - Observable information: Fully observable 2D arena and energy status of all tops. ## Action space - `launch_top(power, angle)`: Selected by each agent at round start (power∈[0.1,1.0], angle∈[0,2π)). ## Playability notes - Single-player-vs-AI: Natural; player configures top launch parameters against AI opponents. - Group games: Naturally scales for 2 to 6 simultaneous competitors. - Physical-skill games: String wrapping and launch snapping are parameterized by the chosen power and aim accuracy. - What is lost: The tactile sensation of winding braided linen and the optical beauty of spinning painted wood. ## Implementation hints Simple 2D disc particle physics simulation with damping and circle-boundary checks. Milestone 1: Implement single-top energy decay and boundary containment. Milestone 2: Implement multi-top collisions and scoring tally.

Download as JSON

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

Download JSON
Cite this page

Spinning Top (Vilciņa Griešana / Latgalian Veļceņš) (Latvia). (n.d.). Games of Countries. https://gamesofcountries.com/games/lv-latvia/vilcins

@misc{gamesofcountries-lv-latvia-vilcins,
  title = {Spinning Top (Vilciņa Griešana / Latgalian Veļceņš) (Latvia)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/lv-latvia/vilcins}
}