Skip to main content
Formal Specification

Boat Game / Snake Boat Race of Kerala — Formal Specification

India · water · Confidence: high

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: discretizedGap-fills: 1
# Vallamkali — AI-optimized specification ## General idea Vallamkali is Kerala's iconic traditional watercraft racing regatta celebrated during Onam. Competing in magnificent 40-meter snake boats (*Chundan Vallam*) manned by over 100 synchronized oarsmen, four helmsmen, and a chorus of boat-song singers (*Chempattukar*), crews race down a 1.4-kilometer buoyed aquatic course. Success depends on maintaining flawless stroke synchronization dictated by the rhythmic cadence of the traditional *Vanchipattu* verses, balancing sprint pacing against collective crew fatigue and hydrodynamic drag. ## Formal model - **Abstraction taken:** The continuous hydrodynamic fluid dynamics of a 100-oarsman snake boat and water resistance are modeled as a 1D forward kinematic system with stochastic cadence error. The 1.4 km straight aquatic course is simulated in discrete time ticks Δt=0.1 seconds (10 Hz). - **Player/agent count:** 2 to 4 competing boats (B1,…,Bm) per heat, each led by a Helmsman/Captain agent commanding stroke cadence and rudder angle. - **Turn model:** Simultaneous continuous real-time simulation. ## Formal rules R1. **Course Architecture & Lane Allocation:** - Straight watercourse of length L=1400 meters, width W=400 meters on Punnamada Lake / Pampa River. - Course partitioned into 4 parallel water lanes (L1,L2,L3,L4) marked with floating buoys. - Each boat starts with its prow aligned behind the starting gate at x=0. R2. **Crew Dynamics & Rhythm Pacing:** - Crew composition per *Chundan Vallam*: 100 Oarsmen (O), 4 Helmsmen (H), 20 Singers (S), 8 Rhythm Setters (R). - The Captain agent sets the Target Stroke Rate ω(t)∈[30,60] strokes per minute (SPM). - **Rhythmic Synchronization:** The rhythm section beats cymbals (*elathalam*) to the *Vanchipattu* meter. - Crew synchronization factor η(t)∈[0.0,1.0] depends on cadence stability and stamina: η(t)=η0−α|ω(t)−ω(t−1)|−β(1−Screw(t))+ϵsync - Effective Propulsion Force: Fprop(t)=Noars⋅foar⋅ω(t)⋅η(t). R3. **Kinematic Progression & Hydrodynamic Drag:** - Boat position and velocity update via Euler integration: v(t+Δt)=v(t)+(Fprop(t)−12CdρAv(t)2Mboat+Mcrew)Δt x(t+Δt)=x(t)+v(t)Δt - Crew stamina decays dynamically: Screw(t+Δt)=Screw(t)−γ⋅ω(t)2⋅Δt. R4. **Infractions & Disqualifications:** - **Lane Encroachment:** If a boat drifts outside its designated lane boundaries (y<ymin⁡ or y>ymax⁡) and interferes with an adjoining vessel, the offending boat is immediately disqualified. - **Man Overboard:** If excessive yaw or violent steering throws a crew member into the water, the boat incurs a +5.0 second time penalty. R5. **Finish & Regatta Resolution:** - Digital laser finish gates and photo-finish cameras record the exact timestamp tfinish when the boat's pointed prow crosses x=1400 meters. - The boat with the lowest elapsed time min⁡(tfinish) in the grand final wins the regatta and claims the silver trophy. - [gap-fill] In case of a photo-finish tie within 0.01 seconds in a knockout heat, both boats advance to the final. ## Edge cases - **Tie at the end condition:** Handled by R5 (high-speed photo-finish cameras resolve ties down to milliseconds; true ties advance both vessels). - **A player with no legal move:** Not applicable — Captain agent outputs continuous stroke rate and rudder commands throughout. - **Repetition / cycles:** Impossible — forward coordinate x(t) monotonically increases toward 1400 m. - **Simultaneous claims on the same resource or position:** Parallel buoyed lanes isolate vessels; collisions or lane intrusions result in disqualification. - **Player elimination mid-round; turn order repair:** Disqualified boat is removed from active scoring; other lanes continue uninterrupted. - **Resource exhaustion (pieces, tokens, space, time):** 1400m distance limit and stamina exhaustion curve strictly bound the sprint duration (≈4–6 minutes of physical race time). - **Termination guarantee: why the game provably ends:** Monotonic forward velocity ensures the finish line x=1400 m is crossed in finite simulation ticks. ## State representation - **Persistent state:** - Regatta tournament bracket; Competing boat entries {B1,…,Bm}. - Crew baseline attributes: (Mtotal,max_power,base_rhythm_skill,S0). - **Per-tick ephemeral state:** - Positional state per boat: (xi(t),yi(t),vi(t),ai(t)). - Current stroke rate ωi(t); Synchronization efficiency ηi(t). - Current crew stamina Screw,i(t)∈[0.0,1.0]. - Elapsed race timer trace∈ℝ≥0. - **Observable information:** Fully observable aquatic course and lane status. ## Action space - `set_stroke_cadence(spm)`: where spm∈[30,60] strokes per minute. - `call_power_surge(duration_sec)`: Calls for a high-intensity sprint burst, rapidly draining stamina for a temporary propulsion boost. - `steer_rudder(angle)`: (Helmsmen), where angle∈[−θmax⁡,+θmax⁡] to maintain straight lane centering. ## Playability notes - **Single-player-vs-AI:** Highly playable as a sports management / pacing strategy game. The player acts as the lead rhythm master (*Chempattukar* / Helmsman), balancing cadence transitions and power surges against crew fatigue over the 1.4 km course. - **Group games (n>4):** 100-man crew decomposes hierarchically into a single Captain agent making macro-cadence decisions for the collective squad. - **Physical-skill games:** Rowing synchronization and *Vanchipattu* rhythm maintenance are modeled via a stability metric penalized by rapid cadence oscillations. - **What is lost in the adaptation:** The thundering resonance of 100 oars hitting the backwaters in unison, the splash of river water, and the choral power of *Vanchipattu* songs echoing across the lake. ## Implementation hints - Implement the hydrodynamic acceleration equation using standard quadratic drag: a(t)=Fprop−kv2M. - Branching factor: Continuous action space (cadence SPM ∈[30,60], rudder angle) easily discretized to 7 discrete cadence gears ×3 sprint modes ≈21 tactical choices per decision tick. - Obvious representational trap: Allowing sudden instantaneous cadence jumps from 30 to 60 SPM without penalizing synchronization; in reality, sudden tempo changes disrupt the 100-man rhythm, collapsing propulsion efficiency. - Suggested first milestone: Implement the 1D kinematic boat model over 1400 meters with cadence-to-thrust equations and verify realistic finish times (≈270–330 seconds).

Download as JSON

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

Download JSON
Cite this page

Vallamkali (India). (n.d.). Games of Countries. https://gamesofcountries.com/games/in-india/vallam-kali

@misc{gamesofcountries-in-india-vallam-kali,
  title = {Vallamkali (India)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/in-india/vallam-kali}
}