Formal Specification
Spinning Top (Vilciņa Griešana / Latgalian Veļceņš) — Formal Specification
Latvia · top-spinning · Confidence: low
← Back to game pageImplementation 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 , radial position , 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 is initialized. Target score points.
R2. Launch: Each round, all active agents simultaneously execute `launch_top(power, launch_angle)`.
R3. [gap-fill] Initial spin energy is sampled: , where .
R4. Top Trajectory and Decay:
- Energy decays per tick: .
- Position undergoes Brownian drift .
- A top is eliminated from the round when or .
R5. **Collision Resolver:** If distance between two tops , a collision occurs [gap-fill]:
- Energy transfer: .
- 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 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 (), 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 .
- Termination guarantee: Monotonically guaranteed by positive energy decay rates per tick.
## State representation
- Persistent state: Match scores vector , round counter.
- Per-turn ephemeral state: For each top : energy , 2D position , velocity vector , 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 (, ).
## 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 JSONCite 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}
}