Skip to main content
Formal Specification

Chinese Diabolo (Playing the Hollow Bamboo) — Formal Specification

China · dexterity-small · Confidence: high

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 3
# Dou Kongzhu — AI-optimized specification ## General idea A traditional Chinese diabolo dexterity and juggling game where players accelerate a hollow bamboo spool (*kongzhu*) on a string held between two hand-sticks, balancing gyroscopic momentum to produce a resonant whistling sound. Players execute a choreographed sequence of aerial tosses, string wraps, limb weaves, and partner transfers of escalating difficulty, managing spool rotational speed and tilt angle to maximize performance points before catching the spool. ## Formal model - **Abstraction taken:** Dynamic string friction, spool aerodynamic drag, and gyroscopic precession are modeled as a state machine tracking rotational velocity (RPM), axial tilt angle (θ), and trick execution success probabilities. - **Player/agent count:** 1 solo performer, or 2 performers in synchronized partner passing. - **Turn model:** Continuous routine divided into sequential trick commitment intervals (ticks of 2.0 seconds, maximum 20 ticks per routine). ## Formal rules R1. Setup: The diabolo starts suspended on the string at RPM=0, tilt=0∘, `score = 0`. Match limit is 20 execution intervals. R2. On each interval, the performer selects an action: - `Accelerate_Spin`: Rhythmic upward pulls; increases RPM by +300 and corrects tilt toward 0∘. - `Throw_and_Catch` (*Toujie*): Aerial toss (height 5–10m); requires RPM≥800; scores +15 pts on clean catch. - `String_Weaving` (*Pansi*): Wrap around limbs; requires RPM≥600; scores +20 pts; increases tilt instability. - `Fishing` (*Diaoyu*): Single-stick dangle; requires RPM≥500; scores +10 pts. - `Over_the_Mountain` (*Fan Shan Yue Ling*): Limb pass; requires RPM≥700; scores +25 pts. - `Decrescendo_Catch`: Concludes the routine cleanly into hand; requires RPM≤400. R3. Gyroscopic Decay & Tilt Drift: - On every interval, natural friction reduces spin: RPM(t+1)=RPM(t)−80. - Complex tricks introduce tilt perturbation: θ(t+1)=θ(t)+Δθtrick+ϵ. R4. Acoustic Resonant Bonus: When RPM≥1000, air whistle vents activate, granting a continuous +2 point bonus per interval for auditory tone quality. R5. Fault Conditions (*Diao Zhu*): - If RPM≤100 during a trick, the spool stalls and drops. - If |θ|≥45∘, the spool rubs against the string and tangles/drops. - If an aerial catch fails (P(drop)=f(toss_height,player_dexterity)), the spool drops to the ground, ending the routine immediately. R6. Score Calculation: Final score is the sum of completed trick points plus acoustic bonuses, minus fault penalties. R7. [gap-fill] Partner Pass Mechanic: In 2-player cooperative mode, tossing the diabolo to a partner grants a ×1.5 score multiplier if caught cleanly, but increases catch failure probability by 15%. R8. [gap-fill] Routine Completion Bonus: Executing a flawless routine of ≥5 distinct tricks and a clean `Decrescendo_Catch` awards a +50 point master bonus. R9. [gap-fill] Base Catch Calibration: For an agent of baseline skill 0.8, standard aerial catch success rate is P(catch)=0.88 at normal launch heights. ## Edge cases - **Tie at the end condition:** In competitive exhibitions, ties are broken by the highest single trick difficulty score, then fewest spin corrections. - **A player with no legal move:** Not applicable; `Accelerate_Spin` is always legal. - **Repetition / cycles:** Repeating the same low-level trick yields diminishing points (50% penalty on repetition); bounded by 20-interval cap. - **Simultaneous claims on the same resource or position:** In solo play, not applicable; in partner pass mode, the airborne spool transitions ownership between agents upon catch. - **Player elimination mid-round:** A ground drop (fault) terminates the active routine and finalizes the score. - **Resource exhaustion:** Rotation decays steadily if not actively maintained. - **Termination guarantee:** Provably terminates within 20 execution intervals by R1. ## State representation - **Persistent state:** `scores[player_id]`, `routine_interval (0..20)`, `tricks_completed_list`. - **Ephemeral state:** `current_RPM (0..2500)`, `tilt_angle_deg (-45..+45)`, `is_airborne_flag`, `whistle_sound_active`. - **Observable information:** Fully observable RPM gauge, tilt angle, interval timer, and score. ## Action space - `execute_routine_action(action_type, parameter)`: Commit diabolo trick or acceleration stroke for the active interval. ## Playability notes - **Single-player-vs-AI:** Highly engaging as an arcade rhythm and combo-building game balancing spin speed maintenance against risky high-point tricks. - **Group games (n>4):** Scales as a synchronized team exhibition where multiple agents juggle and cross-pass diabolos. - **Physical-skill games:** Physical string tension, hand coordination, and visual tracking are modeled via RPM thresholds, tilt variance, and catch probability curves. - **What is lost in the adaptation:** The resonant acoustic whistle echoing through open courtyards, the tactile vibration of the string on wooden sticks, and visual stage presence. ## Implementation hints Discrete state machine with continuous physics attributes (RPM,θ). Trick transitions trigger simple conditional checks against RPM and tilt limits.

Download as JSON

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

Download JSON
Cite this page

Chinese Diabolo (Playing the Hollow Bamboo) (China). (n.d.). Games of Countries. https://gamesofcountries.com/games/cn-china/dou-kongzhu

@misc{gamesofcountries-cn-china-dou-kongzhu,
  title = {Chinese Diabolo (Playing the Hollow Bamboo) (China)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/cn-china/dou-kongzhu}
}