Formal Specification
Boat Game / Snake Boat Race of Kerala — Formal Specification
India · water · Confidence: high
← Back to game pageImplementation 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 seconds (10 Hz).
- **Player/agent count:** 2 to 4 competing boats () 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 meters, width meters on Punnamada Lake / Pampa River.
- Course partitioned into 4 parallel water lanes () marked with floating buoys.
- Each boat starts with its prow aligned behind the starting gate at .
R2. **Crew Dynamics & Rhythm Pacing:**
- Crew composition per *Chundan Vallam*: 100 Oarsmen (), 4 Helmsmen (), 20 Singers (), 8 Rhythm Setters ().
- The Captain agent sets the Target Stroke Rate strokes per minute (SPM).
- **Rhythmic Synchronization:** The rhythm section beats cymbals (*elathalam*) to the *Vanchipattu* meter.
- Crew synchronization factor depends on cadence stability and stamina:
- Effective Propulsion Force: .
R3. **Kinematic Progression & Hydrodynamic Drag:**
- Boat position and velocity update via Euler integration:
- Crew stamina decays dynamically: .
R4. **Infractions & Disqualifications:**
- **Lane Encroachment:** If a boat drifts outside its designated lane boundaries ( or ) 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 second time penalty.
R5. **Finish & Regatta Resolution:**
- Digital laser finish gates and photo-finish cameras record the exact timestamp when the boat's pointed prow crosses meters.
- The boat with the lowest elapsed time in the grand final wins the regatta and claims the silver trophy.
- [gap-fill] In case of a photo-finish tie within 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 monotonically increases toward 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 ( minutes of physical race time).
- **Termination guarantee: why the game provably ends:** Monotonic forward velocity ensures the finish line m is crossed in finite simulation ticks.
## State representation
- **Persistent state:**
- Regatta tournament bracket; Competing boat entries .
- Crew baseline attributes: .
- **Per-tick ephemeral state:**
- Positional state per boat: .
- Current stroke rate ; Synchronization efficiency .
- Current crew stamina .
- Elapsed race timer .
- **Observable information:** Fully observable aquatic course and lane status.
## Action space
- `set_stroke_cadence(spm)`: where 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 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 ():** 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: .
- Branching factor: Continuous action space (cadence SPM , rudder angle) easily discretized to 7 discrete cadence gears sprint modes 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 ( seconds).
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite 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}
}