Formal Specification
Japanese Top Spinning — Formal Specification
Japan · top-spinning · Confidence: low
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 3
# Koma-mawashi — AI-optimized specification
## General idea
A traditional wooden top spinning game comprising spin longevity trials (*Jumyō-kurabe*) and direct circular arena striking battles (*Kenka-goma*). Players wind cords around hardwood tops fitted with steel spindle tips and throw them with sharp wrist snaps to out-spin opponents or smash them out of the ring.
## Formal model
- **Abstraction taken:** Continuous aerodynamic drag, cord release spin torque, gyroscopic precession, and rigid body spindle collisions are abstracted into a discrete tick-based physics proxy. Players select launch power, entry coordinates, and top mass profiles, followed by stochastic collision and spin decay resolution.
- **Player/agent count:** 2 players (standard 1v1 match format) or up to 6 players in multiplayer free-for-all.
- **Turn model:** Sequential throw order in combat duels (*Kenka-goma*); simultaneous launch in endurance trials (*Jumyō-kurabe*).
## Formal rules
R1. Arena setup: A flat circular ring (*dohyō*) of radius `R = 1.0` meters.
R2. Top profiles: Players select top specifications: `(mass: [30..80g], balance: [0.0..1.0], sharpness: [0.0..1.0])`.
R3. Combat Mode (*Kenka-goma*):
- Defender launches first, aiming near center `(0,0)`.
- Attacker launches second, specifying strike coordinates `(x, y)` and launch power `P in [0.5..1.0]`.
R4. Collision and Spin Dynamics:
- If launch accuracy places the attacking top within collision threshold `d_col <= 0.1m`, an impact occurs.
- Displacement vector: `dist_eject = f(mass_attacker, P, sharpness) / balance_defender`.
- Spin decay: Both tops suffer instant angular momentum loss proportional to impact velocity.
R5. Round Resolution:
- Ring Knockout: Any top whose center coordinate exceeds `R` is eliminated immediately.
- Spinout: Any top whose angular velocity decays to zero ceases spinning and loses.
- Winner scores 1 point for the round.
R6. Match Victory: The first player to achieve 3 round points wins the match.
R7. [gap-fill] Failed launch (*Shinike*): If a player's top fails to establish upright spin or lands outside the boundary on launch, that player immediately forfeits the round.
R8. [gap-fill] Round simulation cap: A round executes for a maximum of 100 discrete time ticks; if both tops are still spinning at tick 100, the top with higher remaining angular momentum wins.
R9. [gap-fill] Match tiebreaker: If players are tied after 10 rounds without reaching 3 points, a single sudden-death endurance round (*Jumyō-kurabe*) decides the match.
## Edge cases
- **Tie at the end condition:** Resolved via sudden-death endurance trial (R9).
- **A player with no legal move:** Launch action is always legal during active match rounds.
- **Repetition / cycles:** Bounded by monotonic friction decay on every tick and the 100-tick round cap (R8).
- **Simultaneous claims on the same resource or position:** Collisions resolve symmetrically through momentum conservation equations.
- **Player elimination mid-round:** When a top stops or exits the ring, it is flagged as inactive for the rest of that round.
- **Resource exhaustion:** Tops are persistent and reused across all rounds.
- **Termination guarantee:** Guaranteed by continuous rotational energy dissipation and the 100-tick round cap (R8).
## State representation
- **Persistent state:** `match_scores[2]` (ints in `[0..3]`), `round_index` (int), `role_order` (0 or 1 for defender/attacker).
- **Per-round state:** `tops[2] = {pos: (x,y), vel: (vx,vy), spin_rpm: float, status: SPINNING | EJECTED | DEAD}`.
- **Observable information:** Fully observable game state; in combat mode, attacker observes defender's landing location before aiming.
## Action space
- `launch(power: [0.1..1.0], target_x: float, target_y: float)`: Specify throw power and spatial landing target.
## Playability notes
- **Single-player-vs-AI:** Highly playable; AI evaluates optimal landing offset and spin conservation strategies using trajectory regression.
- **Group games (n>4):** Scales cleanly to 3–6 player simultaneous endurance trials (*Jumyō-kurabe*).
- **Physical-skill games:** Physical cord winding and throwing snap are abstracted into launch precision parameters.
- **What is lost in the adaptation:** The physical sensation of wooden friction, the sound of cord snapping, and craft customization of wooden tops.
## Implementation hints
Discrete tick-based 2D simulation with radial damping. Can be implemented in ~150 lines of code. First milestone: build the 1v1 Kenka-goma collision and boundary knockout engine with static decay parameters.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Japanese Top Spinning (Japan). (n.d.). Games of Countries. https://gamesofcountries.com/games/jp-japan/koma-mawashi
@misc{gamesofcountries-jp-japan-koma-mawashi,
title = {Japanese Top Spinning (Japan)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/jp-japan/koma-mawashi}
}