Formal Specification
Whip-Top Spinning (Ostoros csiga / Facsiga) — Formal Specification
Hungary · top-spinning · Confidence: medium
← Back to game pageImplementation 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 and 1D track position (for racing mode) or 2D position in arena radius (for battle mode). Decay follows . A whip strike injects and forward impulse .
- **Player/agent count:** 1 to 4 agents.
- **Turn model:** Discrete simulation ticks (tick duration s [gap-fill]).
## Formal rules
R1. Setup (Race Mode):
- Track length .
- Each agent starts at with initial spin [gap-fill].
- Minimum sustaining spin threshold .
R2. Actions per Tick: Each agent chooses:
- `WHIP_STRIKE(power: float, forward_angle: float)`: Whip lash with power and angle .
- `COAST()`: Allow top to coast without striking.
R3. Dynamic Resolution:
- Angular decay: per tick.
- If `WHIP_STRIKE` played:
- Spin boost: .
- Forward displacement: [gap-fill].
- Strike accuracy check: If strike misses (probability ), top is disturbed, losing .
- Position and spin update: , .
R4. Topple Condition:
- If : Top wobbles and topples ( freezes; agent is stopped).
R5. Win condition: The first agent to reach with an actively spinning top () wins.
R6. Timeout: If no agent crosses the finish line by tick , the agent with the largest distance wins [gap-fill].
## Edge cases
- Tie at the end condition: If multiple agents cross in the exact same tick, the agent with the higher remaining spin wins [gap-fill].
- A player with no legal move: Not applicable; `COAST` and `WHIP_STRIKE` are always valid.
- Repetition / cycles: Bounded by the 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)`: , .
- `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 JSONCite 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}
}