Skip to main content
Formal Specification

Hmong Spinning Top Contest — Formal Specification

Laos · top-spinning · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 5
# Tuj Lub — AI-optimized specification ## General idea Tuj Lub is the traditional high-velocity team top-spinning sport developed by the Hmong people of the northern Lao highlands. Two teams alternate offensive and defensive roles across a long, narrow court marked with progressive distance stages (Stages 1 through 7). The defending team spins heavy wooden bi-conical tops on the designated stage line; the attacking team launches tops using whip-stick cords to strike the spinning targets. Clearing all defending targets advances the offense to the next distance stage, while a failed attack triggers a role swap with stage progress preserved. ## Formal model - **Abstraction taken:** The high-velocity ballistic trajectory of whip-launched hardwood tops, gyro-dynamic precession, and high-impact physical collisions are abstracted into distance-dependent hit and out-spin probability functions. - **Player/agent count:** 2 teams (TA,TB), each with 1 to 6 agents (k=3 standard squad size) [gap-fill: standard 3-player team format]. - **Turn model:** Sequential innings across 7 progressive distance stages (S∈[1,7]). ## Formal rules R1. Setup & Stage Geometry: - Court features 7 progressive distance stages S1…S7 located at distances D(S)=[4.0,7.0,10.0,13.0,16.0,19.0,22.0] meters from the baseline [gap-fill: 7-stage distance array]. - Each team maintains persistent progress: stage(TA)∈[1,7],stage(TB)∈[1,7], initialized to 1. R2. Defensive Spin Phase: - The active defending team places and spins k tops at stage line D(Scurrent). - Each defending top achieves a baseline spin duration Tdef∼𝒩(μdef,σdef2). R3. Offensive Attack Phase: - The attacking team members take turns launching their tops from the baseline to strike the k defending targets. - For each attack against target j, hit probability: P(hit)=max⁡(0.05,skill−0.03⋅D(S)) [gap-fill]. - Collision Resolution: - Case 1 (Direct Knockdown): If top hits with high impact, defending top topples immediately (Tdef→0); target is eliminated. - Case 2 (Out-Spin Challenge): If both tops remain spinning after impact, attacker must achieve Tatk>Tdef to eliminate the target. - Case 3 (Miss or Loss): Attacking top misses or dies first; target j remains active. R4. Stage Clearance & Role Turnover: - **Stage Cleared:** If all k defending tops are eliminated within the attacking team's allotted attempts, the attacking team advances (stage(Tatk)←stage(Tatk)+1). If the new stage ≤7, the attacking team immediately attempts the next stage. - **Attack Failed:** If any defending top remains active after all attacking attempts, the offensive half ends: roles swap (Tatk↔Tdef). Both teams preserve their accumulated stage progression. R5. Win Condition: - The first team to successfully clear Stage 7 (22-meter distance line) wins the match immediately. R6. [gap-fill] Match Turn Cap: If neither team clears Stage 7 within 20 total half-innings (innings limit), the team with the higher stage progression (or fewest miss attempts) wins. ## Edge cases - **Tie at the end condition:** If both teams reach Stage 7 in the same inning cycle, a sudden-death Stage 7 single-top shootout is played [gap-fill]. - **A player with no legal move:** Not applicable; spinning and whip-launching actions are strictly mandatory per turn. - **Repetition / cycles:** Progress is strictly non-decreasing along the 7 stages; R6's 20-inning cap prevents infinite role-swap cycles. - **Simultaneous claims on the same resource or position:** Attackers declare target top indices sequentially; multiple attackers may target the same remaining top if previous attacks missed. - **Player elimination mid-round; turn order repair:** Not applicable; all team members remain in the launching rotation. - **Resource exhaustion:** Tops are recovered and rewound after each trial. - **Termination guarantee: why the game provably ends:** Guaranteed to terminate because stage progress is strictly monotonic (S∈[1,7]) and bounded by the 20-inning limit in R6. ## State representation - Persistent state: Stage progress (stageA,stageB), active attacking team ID, cumulative inning counter I∈[1,20], team rosters. - Per-stage ephemeral state: Active defending tops array (coordinates, remaining spin timers), remaining attacker attempts queue, target hit booleans. - Observable information: Fully observable — all top locations, active stages, spin states, and match history are public knowledge. ## Action space - `spin_defend(power, balance)`: Execute defensive spin at current stage line. - `whip_strike(target_top_index, launch_power, aim_angle)`: Launch attacking top via whip-stick to strike specific defending top. ## Playability notes - Single-player-vs-AI: Excellent team sports simulation combining risk-reward target selection and distance shooting precision. - Group games (n>4): Plays cleanly in 3v3 or 6v6 squad configurations. - Physical-skill games: Physical whip-stick wrist snap, cord winding tension, and gyro-dynamics are mapped to distance-decaying hit distributions. - What is lost in the adaptation: The visual drama of high-speed hardwood tops sparking upon nail collision, mountain highland winter air, and festive Hmong New Year cheers. ## Implementation hints Model each stage as a target elimination list. Branching factor is small (k target choices per launch). Milestone 1: Implement defensive spin placement and stochastic whip-strike collision resolvers; Milestone 2: Implement stage advancement, role swap transitions, and 7-stage tournament loop.

Download as JSON

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

Download JSON
Cite this page

Hmong Spinning Top Contest (Laos). (n.d.). Games of Countries. https://gamesofcountries.com/games/la-laos/tuj-lub

@misc{gamesofcountries-la-laos-tuj-lub,
  title = {Hmong Spinning Top Contest (Laos)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/la-laos/tuj-lub}
}