Formal Specification
Whipping Top (Spinning Top with Whip) — Formal Specification
Czechia · top-spinning · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 3
# Káča s bičíkem — AI-optimized specification
## General idea
A resource-management and timing contest where agents maintain the angular momentum and spatial trajectory of a physical spinning top. In each discrete time tick, an agent decides the timing, force, and strike angle of whip actions to maximize rotational energy and stability while mitigating the risk of tipping over due to mistimed impacts or decay.
## Formal model
- **Abstraction taken:** The continuous rotational mechanics and chaotic fluid contact between leather whip and wooden grooved top are replaced by a state-vector dynamic model tracking angular velocity , stability/precession angle , and 2D spatial coordinate .
- **Player/agent count:** 2 agents in standard head-to-head heat (scalable from 1 to ).
- **Turn model:** Synchronous discrete time ticks (e.g. 1 tick = 0.5s of simulated physical time).
## Formal rules
R1. Setup: Each agent starts with a top initialized at state with , (perfect vertical spin), and position in designated starting zone.
R2. In each tick , agent chooses one action from the legal action set:
- `whip(force, angle_offset)` where (integer power level) and .
- `steer(dir)` to nudge lateral trajectory along vector .
- `pass` (let the top spin unassisted).
R3. Physics & Stochastic Resolution (per tick):
- Passive decay: where is ground/air friction and is wobble drag.
- If `pass`: (stability degrades as angular velocity drops).
- If `whip(force, angle)`:
- [gap-fill] Strike Success Check: Strike accuracy depends on current wobble and agent skill : .
- If Clean Hit: , and .
- If Mistimed / Glancing Hit: , and (instability increases).
R4. Top Fall Condition: A top falls ("dies") if OR .
R5. [gap-fill] Collision Resolution (Duel Mode): If distance , tops collide: higher kinetic energy () transfers momentum, inflicting stability penalty on the weaker top.
R6. Win / Loss / Draw:
- In Endurance Mode: The last agent whose top remains spinning () wins 1 point.
- If both tops fall on the exact same tick, the round is scored as a draw.
R7. [gap-fill] Max Round Limit: If both tops remain spinning at ticks, the agent with higher accumulated angular velocity is declared the winner.
## Edge cases
- Tie at the end condition: Resolved by comparing final residual at , or declared a tie if within tolerance .
- A player with no legal move: Not applicable; `pass` and `whip` actions are unconditionally available every tick.
- Repetition / cycles: Strictly bounded by physical friction decay parameters and the absolute hard tick ceiling .
- Simultaneous claims on the same resource or position: Handled by R5 (physical collision resolver based on kinetic energy inequality).
- Player elimination mid-round: An agent whose top dies transitions to eliminated state; remaining agents continue until one survivor remains.
- Resource exhaustion: Not applicable; whip strikes are non-consumable, though energy efficiency governs strike frequency.
- Termination guarantee: Guaranteed by monotonic friction decay , wobble instability amplification R3, and hard ceiling .
## State representation
- Persistent state: Match format (Endurance / Obstacle / Duel), cumulative match score, agent skill parameters.
- Per-tick ephemeral state (per agent ): Angular velocity , wobble angle , 2D coordinate , alive boolean, tick counter .
- Observable information: Fully observable in standard matches (both agents observe exact , and positions of both tops).
## Action space
- `whip(force, angle_offset)`: , .
- `steer(dx, dy)`: normalized 2D direction unit vector.
- `pass`: no-op (observe and let top coast).
## Playability notes
- Single-player-vs-AI: Natural and highly engaging. A single agent can play a high-score endurance challenge (keeping top alive for maximum ticks) or compete against an AI opponent balancing risk-reward whipping strategies.
- Group games (n>4): Scales cleanly as a multi-agent survival battle-royale in a shared collision arena.
- Physical-skill games: Physical whip timing and tangential impact angle are modeled as a stochastic control problem balancing power vs. stability risk.
- What is lost: The physical muscle memory of flicking a wrist, braided leather rope wear, and surface terrain irregularities are abstracted into scalar equations.
## Implementation hints
Treat as a discrete-time Markov Decision Process (MDP). The optimal policy balances whipping when begins to dip while avoiding over-whipping when wobble is elevated. First milestone: implement single-top 1D state with deterministic decay and stochastic whip responses; second milestone: add 2D spatial arena and multi-agent collision mechanics.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Whipping Top (Spinning Top with Whip) (Czechia). (n.d.). Games of Countries. https://gamesofcountries.com/games/cz-czechia/kaca-s-bicikem
@misc{gamesofcountries-cz-czechia-kaca-s-bicikem,
title = {Whipping Top (Spinning Top with Whip) (Czechia)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/cz-czechia/kaca-s-bicikem}
}