Skip to main content
Formal Specification

Whip-Top Spinning (Ostoros csiga / Facsiga) — Formal Specification

Hungary · top-spinning · Confidence: medium

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 5
# Csigázás — AI-optimized specification ## General idea A real-time or turn-based kinetic control game where agents modulate the timing, striking angle, and power of whip lashes applied to a spinning conical top, balancing rotational angular velocity (to prevent toppling) against translational propulsion along a 20-meter race track or inside a collision arena. ## Formal model - **Abstraction taken:** The continuous physics of rotational mechanics is discretized into an angular velocity state ωi∈[0,100] rad/s and 1D track position xi∈[0,20.0] meters (for racing mode) or 2D position (xi,yi) in arena radius R=1.0 m (for battle mode). Decay follows ω˙=−kfrictionω. A whip strike injects Δω=f(Power) and forward impulse Δx=g(Angle,Power). - **Player/agent count:** 1 to 4 agents. - **Turn model:** Discrete simulation ticks (tick duration 0.25 s [gap-fill]). ## Formal rules R1. Setup (Race Mode): - Track length L=20.0 m. - Each agent starts at xi=0.0 with initial spin ωi=60.0 rad/s [gap-fill]. - Minimum sustaining spin threshold ωmin⁡=10.0 rad/s. R2. Actions per Tick: Each agent i chooses: - `WHIP_STRIKE(power: float, forward_angle: float)`: Whip lash with power p∈[10,50] and angle θ∈[0∘,60∘]. - `COAST()`: Allow top to coast without striking. R3. Dynamic Resolution: - Angular decay: ωi←max⁡(0,ωi−2.5) per tick. - If `WHIP_STRIKE` played: - Spin boost: Δω=p×cos⁡(θ)×(Skilli/100). - Forward displacement: Δx=0.05×p×sin⁡(θ)×(Skilli/100) [gap-fill]. - Strike accuracy check: If strike misses (probability Pmiss=0.15×(1−Skilli/100)), top is disturbed, losing −15 rad/s. - Position and spin update: xi←xi+Δx, ωi←min⁡(100.0,ωi+Δω). R4. Topple Condition: - If ωi<ωmin⁡: Top wobbles and topples (xi freezes; agent is stopped). R5. Win condition: The first agent to reach xi≥20.0 with an actively spinning top (ωi≥ωmin⁡) wins. R6. Timeout: If no agent crosses the finish line by tick Tmax⁡=120, the agent with the largest distance xi wins [gap-fill]. ## Edge cases - Tie at the end condition: If multiple agents cross x≥20.0 in the exact same tick, the agent with the higher remaining spin ωi wins [gap-fill]. - A player with no legal move: Not applicable; `COAST` and `WHIP_STRIKE` are always valid. - Repetition / cycles: Bounded by the Tmax⁡=120 tick ceiling. - Simultaneous claims on the same resource or position: Agents operate in parallel race lanes without track blocking. - Player elimination mid-round; turn order repair: A toppled top stops advancing but remains in state logs; active agents continue racing. - Resource exhaustion (pieces, tokens, space, time): Track length is fixed; tick counter decrements to 0. - Termination guarantee: Enforced by the finite 120-tick ceiling and monotonic position advancement. ## State representation - Persistent state: `tick: int (1..120)`, `positions: dict[int, float]`, `spin_velocities: dict[int, float]`, `is_toppled: dict[int, bool]`. - Per-tick ephemeral state: `whip_actions: dict[int, tuple[float, float]]`, `strike_outcomes: dict[int, bool]`. - Observable information: Fully observable. All agents see track positions, spin estimates, and competitor states. ## Action space - `whip_strike(power: float, forward_angle: float)`: p∈[10,50], θ∈[0∘,60∘]. - `coast()`: No-op. ## Playability notes - Single-player-vs-AI: Fun physics-balance race against time or AI bots; player must carefully manage spin conservation against forward speed. - Group games (n>4): Easily scales up to 4 parallel racing lanes. - Physical-skill games: Rotational gyroscopic stability and whip lash timing are abstracted into coupled differential equations. - What is lost in the adaptation: Whipping sound, tactile handle feedback, and ice surface irregularities. ## Implementation hints Low complexity. Simple 1D kinematic integration loop with exponential decay. First milestone: Verify that pure forward strikes cause spin decay and toppling, whereas balanced 45-degree strikes sustain both velocity and spin to cross the finish line.

Download as JSON

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

Download JSON
Cite this page

Whip-Top Spinning (Ostoros csiga / Facsiga) (Hungary). (n.d.). Games of Countries. https://gamesofcountries.com/games/hu-hungary/csigazas

@misc{gamesofcountries-hu-hungary-csigazas,
  title = {Whip-Top Spinning (Ostoros csiga / Facsiga) (Hungary)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/hu-hungary/csigazas}
}