Skip to main content
Formal Specification

Spinning Top Games (Kreesel / Spëndel) — Formal Specification

Luxembourg · top-spinning · Confidence: low

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Kreeseldreien — AI-optimized specification ## General idea A physical contest simulation modeled on traditional Luxembourgish wooden spinning-top combat. Two agents launch spinning tops into a 2D circular ring with specified angular velocity, position, and entry angle, managing rotational momentum, ring boundary positioning, and collision impacts to knock the opponent out or outlast their spin. ## Formal model - **Abstraction taken:** Continuous rotational mechanics and surface precession are abstracted into state vectors for each top: position (x,y)∈ℝ2, angular velocity ω∈[0,ωmax⁡], and stability σ∈[0.0,1.0]. Discrete time steps t∈[1..Tmax⁡] resolve friction decay and collision dynamics. - **Player/agent count:** 2 agents (A0 and A1). - **Turn model:** Simultaneous initial launch parameters, followed by autonomous continuous simulation ticks. ## Formal rules R1. Setup: A circular arena with radius R=1.0 centered at (0,0). Each agent selects launch parameters: target drop point (xinit,yinit), launch spin power P∈[0.5,1.0], and tilt angle θ∈[0,π/4]. R2. Simulation Tick: Every time step Δt=0.1: - Angular velocity decays due to friction: ω(t+Δt)=ω(t)−μfrictionΔt. - Stability decreases as ω drops: σ(t)=min⁡(1.0,ω(t)/ωcritical). - Position drifts towards center or precesses in an orbit: p(t+Δt)=p(t)+v(t)Δt. R3. Collision Resolution: If Euclidean distance ‖p0(t)−p1(t)‖≤2rtop: - Momentum exchange transfers velocity: Δv∝|ω0(t)−ω1(t)|. - Stability shock applied: σi←σi−Δσimpact. R4. Elimination Conditions: An agent's top is eliminated if: - Ring exit: ‖pi(t)‖>R (knocked out of the ring). - Topple: ωi(t)≤0 or σi(t)≤0 (top stops or falls on its side). R5. Win condition: The agent whose top remains actively spinning inside the arena when the opponent's top is eliminated wins the round. R6. [gap-fill] Time limit & Draw: If both tops remain spinning at Tmax⁡=100 ticks, the top with the higher remaining angular velocity ωi(Tmax⁡) wins. ## Edge cases - Tie at the end condition: If both tops stop spinning on the exact same simulation tick within Δt, the round is declared a draw. - A player with no legal move: Not applicable — launch parameters are selected from continuous bounding intervals. - Repetition / cycles: Angular velocity ω strictly decreases monotonically every tick due to friction, guaranteeing termination. - Simultaneous claims on the same resource or position: Simultaneous collision mechanics resolve symmetrically via elastic vector exchange (R3). - Player elimination mid-round; turn order repair: Bout ends immediately upon first elimination (R4). - Resource exhaustion: Not applicable — one top per agent per round. - Termination guarantee: Provably terminates within Tmax⁡=100 ticks due to mandatory friction decay μfriction>0. ## State representation - Persistent state: Round counter, match score [S0,S1]. - Per-round state: Top state vectors [(x0,y0,ω0,σ0),(x1,y1,ω1,σ1)], active status booleans. - Observable information: Fully observable physics state. ## Action space - `launch_top(target_x, target_y, power, tilt)`: Continuous or discretized parameters chosen during round setup. ## Playability notes - Single-player-vs-AI: Natural — human player inputs top launch coordinates against AI targeting heuristics to practice ring knockouts. - Group games (n>4): Extends to a multi-top battle royale arena with 4 to 8 agents launched into a larger circle. - Physical-skill games: Abstracted to strategic launch positioning and spin management. - What is lost: The physical hand-feel of winding hemp cord around carved wood and the sharp snap of the whip. ## Implementation hints Standard 2D rigid-body circle collision simulation. First milestone: implement angular velocity decay and distance check in a 2D boundary.

Download as JSON

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

Download JSON
Cite this page

Spinning Top Games (Kreesel / Spëndel) (Luxembourg). (n.d.). Games of Countries. https://gamesofcountries.com/games/lu-luxembourg/kreeseldreien

@misc{gamesofcountries-lu-luxembourg-kreeseldreien,
  title = {Spinning Top Games (Kreesel / Spëndel) (Luxembourg)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/lu-luxembourg/kreeseldreien}
}