Formal Specification
Burmese Top-Spinning Combat (Gyin / Top Battle) — Formal Specification
Myanmar · top-spinning · Confidence: high
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 3
# Gyin-pauk — AI-optimized specification
## General idea
A competitive top-spinning combat and targeting game. Players first spin their tops simultaneously in a qualifying trial; the player whose top stops spinning first becomes the "Dead Top" (Defender), placing their stationary top inside a circular dirt ring. The remaining players (Attackers) whip their tops forcefully into the ring to knock out or chip the target top. Failed launches or tops dying inside the ring become secondary targets, creating a dynamic multi-target hazard zone.
## Formal model
- **Abstraction taken:** 3D rotational mechanics, precession, and hardwood collision physics are abstracted into 2D planar coordinates on a circular ring of radius meter centered at . Top launches are modeled as stochastic outcomes parameterized by player aim, launch velocity, and spin stability . Collision displacement vectors are resolved via discrete momentum transfer formulas.
- **Player/agent count:** 2 to 6 individual players.
- **Turn model:** Phase 1 simultaneous qualification spin; Phase 2 sequential strike turns by active attackers.
## Formal rules
R1. **Ring Geometry & Initial Setup:** A circular arena centered at has radius m. Each player owns 1 wooden top with durability and a score .
R2. **Phase 1 — Qualifying Spin (*Gyin A-the / A-shin*):**
- All players execute a simultaneous spin test outside the arena.
- Each player samples a spin duration: .
- The player with the minimum duration is designated the `Defender` (*Gyin A-the*).
- The Defender's top is placed stationary at the ring center as the primary `Target`.
- The remaining players become `Attackers` (*Gyin A-shin*), ordered by ascending .
R3. **Phase 2 — Combat Launch (*Gyin-pauk*):**
Each active attacker , in turn order, chooses a target from the set of active targets inside the ring and executes a launch action:
1. *Launch Accuracy Check:*
2. *Collision & Ejection:*
- If hit succeeds: target receives an impulse displacing it toward coordinate . If , target is **Ejected** (*Khat-htwet*). Attacker scores point (). Target receives 10 durability damage.
- If target was the original Defender's top and was ejected, the Defender remains the target for another turn or takes a penalty point.
3. *Attacker Landing & Spin Check:*
- The attacker's top lands at coordinate with spin duration .
- If and (top dies inside the ring): Attacker 's top becomes an **additional dead target** added to . Attacker loses active attacker status until liberated.
- If and : The top spins safely and drifts outside or is retrieved after stopping. Attacker gains safe bonus point.
- If the attacker top completely misses and lands outside the ring with : Foul; becomes a dead target placed on the ring edge [gap-fill].
R4. **Round Resolution & Role Swapping:**
- If all attackers complete their throws and the Defender's top was NOT ejected, the Defender is liberated (*A-lut*), and the attacker who produced the worst throw becomes the new Defender for the next round.
- If a new player's top dies inside the ring during Phase 2, that player becomes the Defender for the subsequent round.
R5. **Victory Condition:** The match is played over rounds. The player with the highest total score (or the last surviving player whose top durability ) wins the match.
R6. [gap-fill] Turn Cap Per Round:** If multiple tops become trapped inside the ring, a round ends after a maximum of total launch attempts, at which point all trapped tops are cleared and a new qualifying spin (Phase 1) is conducted.
## Edge cases
- Tie at the end condition: If two or more players have equal points at the end of , a sudden-death qualifying spin (Phase 1) determines the winner (longest spin wins) [gap-fill].
- A player with no legal move: Not applicable; an active attacker always possesses the legal action to target any top in . If all players except the target are trapped inside, the round resets immediately per R6.
- Repetition / cycles: Bounded by the launch cap per round in R6 and the global match limit .
- Simultaneous claims on the same resource or position: Phase 1 spins are resolved simultaneously by scalar sorting; Phase 2 attacks are strictly sequential.
- Player elimination mid-round; turn order repair: If an attacker's top dies inside the ring, they are removed from the attacker queue for the rest of that round; turn order simply skips to the next active attacker.
- Resource exhaustion (pieces, tokens, space, time): Tops are bounded by initial player count ; ring area is bounded ( m).
- Termination guarantee: why the game provably ends: Guaranteed by strictly bounded attacker queues, round turn limits (R6), and finite round structure .
## State representation
- **Persistent state:** Number of players , player scores , top durabilities , current round .
- **Per-turn ephemeral state:** List of active dead targets with 2D positions , current attacker ID, remaining attacker queue, launch outcomes.
- **Observable information:** Fully observable; all top positions, scores, and durabilities are public to all players.
## Action space
- `qualify_spin()`: Execute spin in Phase 1 to determine round roles.
- `launch_attack(target_id, power, angle)`: Aim and launch spinning top at a designated target with specified power and angle . Precondition: Agent is active attacker in Phase 2.
## Playability notes
- Single-player-vs-AI: Very engaging; human player aims launches against AI targets and dead tops, balancing high-power knockout attempts against the risk of dying inside the ring.
- Group games (n>4): Natively scales from 2 to 6 players; each player acts as an independent combatant in the queue.
- Physical-skill games: String-wrapping tension, throwing angle, and gyroscopic top stability are parameterized by skill , power choices, and distance functions.
- What is lost in the adaptation: The tactile feel of string wrapping, hardwood scent, nail sharpness, and the physical sound of wood splitting under impact.
## Implementation hints
Medium complexity. Requires a 2D spatial collision engine tracking radial distance for ring containment and vector knockback on impact. First milestone: implement 2-player duel (1 attacker, 1 defender) with hit/miss ejection probabilities and verify role transitions.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Burmese Top-Spinning Combat (Gyin / Top Battle) (Myanmar). (n.d.). Games of Countries. https://gamesofcountries.com/games/mm-myanmar/gyin-pauk
@misc{gamesofcountries-mm-myanmar-gyin-pauk,
title = {Burmese Top-Spinning Combat (Gyin / Top Battle) (Myanmar)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/mm-myanmar/gyin-pauk}
}