Formal Specification
Chinese Diabolo (Playing the Hollow Bamboo) — Formal Specification
China · dexterity-small · Confidence: high
← Back to game pageImplementation 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 (), 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 , , `score = 0`. Match limit is 20 execution intervals.
R2. On each interval, the performer selects an action:
- `Accelerate_Spin`: Rhythmic upward pulls; increases by and corrects tilt toward .
- `Throw_and_Catch` (*Toujie*): Aerial toss (height 5–10m); requires ; scores pts on clean catch.
- `String_Weaving` (*Pansi*): Wrap around limbs; requires ; scores pts; increases tilt instability.
- `Fishing` (*Diaoyu*): Single-stick dangle; requires ; scores pts.
- `Over_the_Mountain` (*Fan Shan Yue Ling*): Limb pass; requires ; scores pts.
- `Decrescendo_Catch`: Concludes the routine cleanly into hand; requires .
R3. Gyroscopic Decay & Tilt Drift:
- On every interval, natural friction reduces spin: .
- Complex tricks introduce tilt perturbation: .
R4. Acoustic Resonant Bonus: When , air whistle vents activate, granting a continuous point bonus per interval for auditory tone quality.
R5. Fault Conditions (*Diao Zhu*):
- If during a trick, the spool stalls and drops.
- If , the spool rubs against the string and tangles/drops.
- If an aerial catch fails (), 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 score multiplier if caught cleanly, but increases catch failure probability by .
R8. [gap-fill] Routine Completion Bonus: Executing a flawless routine of distinct tricks and a clean `Decrescendo_Catch` awards a point master bonus.
R9. [gap-fill] Base Catch Calibration: For an agent of baseline skill , standard aerial catch success rate is 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 ( 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 (). 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 JSONCite 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}
}