Formal Specification
Spinning Top Games (Kreesel / Spëndel) — Formal Specification
Luxembourg · top-spinning · Confidence: low
← Back to game pageImplementation 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 , angular velocity , and stability . Discrete time steps resolve friction decay and collision dynamics.
- **Player/agent count:** 2 agents ( and ).
- **Turn model:** Simultaneous initial launch parameters, followed by autonomous continuous simulation ticks.
## Formal rules
R1. Setup: A circular arena with radius centered at . Each agent selects launch parameters: target drop point , launch spin power , and tilt angle .
R2. Simulation Tick: Every time step :
- Angular velocity decays due to friction: .
- Stability decreases as drops: .
- Position drifts towards center or precesses in an orbit: .
R3. Collision Resolution: If Euclidean distance :
- Momentum exchange transfers velocity: .
- Stability shock applied: .
R4. Elimination Conditions: An agent's top is eliminated if:
- Ring exit: (knocked out of the ring).
- Topple: or (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 ticks, the top with the higher remaining angular velocity wins.
## Edge cases
- Tie at the end condition: If both tops stop spinning on the exact same simulation tick within , 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 ticks due to mandatory friction decay .
## State representation
- Persistent state: Round counter, match score .
- Per-round state: Top state vectors , 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 JSONCite 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}
}