Skip to main content
Formal Specification

Spring Festival Bamboo Swinging / Giant Swing — Formal Specification

Vietnam · strength-endurance · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 4
# Đánh đu — AI-optimized specification ## General idea Đánh đu is a dynamic Vietnamese spring festival giant swing game where competitors stand upright on a suspended wooden platform and execute rhythmic whole-body pumping motions (*nhún đu*) to drive the swing into soaring vertical arcs. Competitors manage stamina and phase-timing precision to maximize arc elevation, aiming to reach horizontal crossbar alignment or snatch an elevated prize ribbon at the peak of the trajectory. ## Formal model - **Abstraction taken:** The continuous pendulum kinematics and counter-phase biomechanical pumping are modeled as a discrete-cycle harmonic oscillator with stamina fatigue. Each swing cycle requires an agent to commit a pumping impulse with an effort level and timing offset relative to the swing's nadir/inflection points [gap-fill: continuous biomechanical swinging and pendulum physics are discretized into a discrete-cycle harmonic oscillator model where agents select pump timing and effort per cycle]. - **Player/agent count:** 1 agent (solo challenge) or 2 agents (paired tandem team or competitive duel). - **Turn model:** Cycle-by-cycle synchronized discrete decision steps (c=1,…,Cmax). ## Formal rules R1. State and Setup: - Swing state is characterized by current maximum angle θ∈[0∘,90∘] (initially θ0=10∘), angular velocity ω, and agent stamina Ei∈[0,100] (initially 100). - Target prize ribbon is positioned at θtarget=80∘. R2. Cycle Pumping Mechanics (per half-period cycle c): - Active agent(s) submit action a=(effort,Δt), where effort∈[0,10] and timing offset Δt∈[−0.5,+0.5] seconds from the optimal nadir inflection point. - In paired tandem mode, both agents submit actions; energy gain depends on synchronization |Δt1−Δt2|. R3. [gap-fill] Angular Energy and Damping Update: - Energy input per cycle: ΔK=effort⋅exp⁡(−(Δt/σ)2)⋅(Ei/100). - Mechanical damping: natural dissipation γ=0.08. - New peak angle: θc+1=clamp(θc⋅(1−γ)+α⋅ΔK,0∘,90∘). - Stamina cost: Ei←max⁡(0,Ei−1.2⋅effort). R4. [gap-fill] Prize Snatch Condition: - When θc≥θtarget=80∘, the agent may execute `snatch_ribbon()`. - Snatch success is sampled from Bernoulli(Psnatch), where Psnatch=0.90. - A successful snatch ends the bout immediately with a Grand Prize victory. R5. [gap-fill] Cycle Limit and Judging: - If Cmax=25 cycles elapse without a ribbon snatch (or stamina reaches 0), the trial concludes. - The competitor's final score is their highest achieved peak angle θmax=maxc⁡θc. - In duel format, the agent with the higher θmax wins; ties are broken by remaining stamina Ei. ## Edge cases - Tie at the end condition: Handled by R5 (broken by higher peak angle θmax, then remaining stamina). - A player with no legal move: Not applicable; an agent with 0 stamina can still execute `effort = 0` (passive swinging). - Repetition / cycles: Bounded by the hard cycle limit Cmax=25. - Simultaneous claims on the same resource or position: In tandem play, both swingers share the single platform; in duel play, competitors swing in separate sequential trials or parallel frames. - Player elimination mid-round; turn order repair: If an agent exhausts stamina, their swing gradually decays under damping until Cmax expiration. - Resource exhaustion: Stamina Ei depletes monotonically with effort; bounded at zero. - Termination guarantee: why the game provably ends: Guaranteed by R5 (c≤25 cycles limit). ## State representation - Persistent state: - `current_cycle`: integer c∈[1,25]. - `current_angle`: float θ∈[0∘,90∘]. - `peak_angle_achieved`: float θmax. - `stamina`: array of floats [E1,E2]. - `prize_snatched`: boolean. - Per-round ephemeral state: - `timing_offsets`: chosen Δt. - `efforts_applied`: chosen effort values. - Observable information: - Fully observed by all agents: current swing angle, peak angle, stamina meters, and elapsed cycle count. ## Action space - `pump(effort, timing_offset)`: effort ∈[0,10], timing_offset ∈[−0.5,0.5]. - `snatch_ribbon()`: valid when θ≥80∘. ## Playability notes - Single-player-vs-AI: Natural as a rhythmic timing and stamina optimization challenge (reach 80∘ and snatch the prize in minimum cycles). - Group games (n>4): Not applicable; swinging is inherently 1–2 players per frame. Tournament brackets of 1v1 duels generalize across larger groups. - Physical-skill games: Physical balance and explosive leg pumping are mapped to the 2D action space of effort and timing accuracy. - What is lost in the adaptation: The vertiginous somatic rush of soaring 8 meters into the open sky, the centrifugal rush of wind, and the roaring communal drum rolls. ## Implementation hints - Implement as a simple numeric ODE / difference equation simulation. - Visualizable via a 2D pendulum canvas with an interactive timing bar. - Suggested first milestone: Implement R1–R3 difference equations and verify that optimal timing (Δt=0, effort = 8) reaches 80∘ in 6–8 cycles.

Download as JSON

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

Download JSON
Cite this page

Spring Festival Bamboo Swinging / Giant Swing (Vietnam). (n.d.). Games of Countries. https://gamesofcountries.com/games/vn-vietnam/danh-du

@misc{gamesofcountries-vn-vietnam-danh-du,
  title = {Spring Festival Bamboo Swinging / Giant Swing (Vietnam)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/vn-vietnam/danh-du}
}