Formal Specification
Spring Festival Bamboo Swinging / Giant Swing — Formal Specification
Vietnam · strength-endurance · Confidence: low
← Back to game pageImplementation 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 ().
## Formal rules
R1. State and Setup:
- Swing state is characterized by current maximum angle (initially ), angular velocity , and agent stamina (initially 100).
- Target prize ribbon is positioned at .
R2. Cycle Pumping Mechanics (per half-period cycle ):
- Active agent(s) submit action , where and timing offset seconds from the optimal nadir inflection point.
- In paired tandem mode, both agents submit actions; energy gain depends on synchronization .
R3. [gap-fill] Angular Energy and Damping Update:
- Energy input per cycle: .
- Mechanical damping: natural dissipation .
- New peak angle: .
- Stamina cost: .
R4. [gap-fill] Prize Snatch Condition:
- When , the agent may execute `snatch_ribbon()`.
- Snatch success is sampled from , where .
- A successful snatch ends the bout immediately with a Grand Prize victory.
R5. [gap-fill] Cycle Limit and Judging:
- If cycles elapse without a ribbon snatch (or stamina reaches 0), the trial concludes.
- The competitor's final score is their highest achieved peak angle .
- In duel format, the agent with the higher wins; ties are broken by remaining stamina .
## Edge cases
- Tie at the end condition: Handled by R5 (broken by higher peak angle , 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 .
- 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 expiration.
- Resource exhaustion: Stamina depletes monotonically with effort; bounded at zero.
- Termination guarantee: why the game provably ends: Guaranteed by R5 ( cycles limit).
## State representation
- Persistent state:
- `current_cycle`: integer .
- `current_angle`: float .
- `peak_angle_achieved`: float .
- `stamina`: array of floats .
- `prize_snatched`: boolean.
- Per-round ephemeral state:
- `timing_offsets`: chosen .
- `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 , timing_offset .
- `snatch_ribbon()`: valid when .
## Playability notes
- Single-player-vs-AI: Natural as a rhythmic timing and stamina optimization challenge (reach 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 (, effort = 8) reaches in 6–8 cycles.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite 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}
}