Formal Specification
Cord-Spun Wooden Top Striking — Formal Specification
Pakistan · dexterity-small · Confidence: low
← Back to game pageImplementation Suitability
Suitability: engine-readyFidelity: probabilistic-proxyGap-fills: 1
# Lattu — AI-optimized specification
## General idea
A turn-based 2D physics and ring-combat game. Players launch spinning tops into a circular ring to maintain gyroscopic rotational stability or strike stationary penalty tops out of the boundary. The combat loop resolves projectile landing accuracy, collision impulse transfer, and rotational friction decay over time.
## Formal model
- **Abstraction taken:** The circular ring is a 2D bounding circle `x^2 + y^2 <= R^2` with `R = 0.75` meters. Top dynamics are modeled by 2D position `(x, y)`, linear velocity `(vx, vy)`, and scalar rotational speed `omega in [0, 300]` rad/s.
- **Player/agent count:** `N` players (standard `N = 3`).
- **Turn model:** Sequential combat turns alternating among active players.
## Formal rules
R1. Setup: Ring radius `R = 0.75` meters at center `(0, 0)`. Stationary target tops `T_target` start inside `x^2 + y^2 <= 0.2^2` with `omega = 0`.
R2. Launch Action: Active player `i` selects launch parameter vector `(power, angle, target_pos)`.
- Landing coordinate `(x_0, y_0) = target_pos + Gaussian(0, sigma_launch(skill))`.
- Initial rotational speed `omega_0 = power * 60.0 * skill`.
- If `omega_0 < 50.0`: Top fails to spin -> Top becomes stationary penalty top inside ring.
R3. Gyroscopic Decay & Movement:
- On each simulation tick `Delta_t = 0.1` s: `omega(t + dt) = omega(t) - k_decay * dt`.
- Drift velocity `(vx, vy)` updates under ground precession.
R4. Collision Resolution:
- If spinning top `i` collides with stationary target top `j`:
- Linear momentum transfers via elastic collision: `v_j = (2 * m_i / (m_i + m_j)) * v_i`.
- If top `j` exits ring `x_j^2 + y_j^2 > R^2`: Top `j` is ejected (`ejected[j] = True`). Player `i` scores 10 points.
- Spike split check (*Cheer*): If strike speed exceeds threshold `v_impact > 3.0` m/s, `P(split) = 0.25` -> Bonus 20 points.
R5. Top Expiration: When `omega <= 0`, top `i` stops spinning.
- If top `i` stops inside the ring `x_i^2 + y_i^2 <= R^2`: Top `i` transitions to stationary penalty top.
R6. Win condition: The game terminates when all stationary penalty tops are ejected from the ring. The player with the highest accumulated score wins.
R7. [gap-fill] Max rounds: If penalty tops remain after 30 combat rounds, the player with the most ejections wins.
## Edge cases
- **Tie at the end condition:** Handled by point accumulation across 30 rounds (R7).
- **A player with no legal move:** Launch parameter selection is always legal.
- **Repetition / cycles:** Rotational speed `omega` strictly decreases to zero monotonically each launch, ensuring termination of active simulation within finite ticks.
- **Simultaneous claims on the same resource or position:** Physics collision resolver handles multi-body contacts deterministically.
- **Player elimination mid-round:** Players with active penalty tops remain in rotation to strike remaining tops.
- **Resource exhaustion:** Tops inside the ring decrement as they are successfully knocked out.
- **Termination guarantee:** Guaranteed by finite round limit (R7) and monotonic friction decay per throw.
## State representation
- **Persistent state:** `scores[1..N]`, `round_counter in {1..30}`, `active_player_idx in {1..N}`.
- **Per-launch ephemeral state:** Coordinates, velocities, and `omega` for all tops in the arena, `ejected_flags[1..K]`.
- **Observable information:** Fully observable 2D positions, velocities, and spin status.
## Action space
- `launch_top(power, angle, target_x, target_y)`: Continuous parameter selection.
## Playability notes
- **Single-player-vs-AI:** Natural; human player aims spinning strikes to eject stationary targets while preventing their own top from stalling inside the ring.
- **Group games (n>4):** Sequential turn rotation extends cleanly across multiple players.
- **Physical-skill games:** Wrist whip mechanics and string uncoiling physics are parameterized via `omega_0` and landing dispersion `sigma_launch`.
- **What is lost:** The tactile satisfaction of winding the cotton string neatly along the grooved wooden body and catching the spinning top on the palm of the hand.
## Implementation hints
Low complexity. 2D rigid disc physics with continuous rotational velocity decay. Implement the `omega` decay and elastic collision impulse transfer first.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Cord-Spun Wooden Top Striking (Pakistan). (n.d.). Games of Countries. https://gamesofcountries.com/games/pk-pakistan/lattu
@misc{gamesofcountries-pk-pakistan-lattu,
title = {Cord-Spun Wooden Top Striking (Pakistan)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/pk-pakistan/lattu}
}