Formal Specification
Orange-Tossing and Juggling Contest — Formal Specification
Sri Lanka · dexterity-small · Confidence: high
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: probabilistic-proxyGap-fills: 2
# Dodan Keliya — AI-optimized specification
## General idea
Dodan Keliya is a traditional Sri Lankan citrus juggling and aerial dexterity sport. Players juggle 3 to 7 wild bitter oranges (*dodan*) in continuous cascades, attempting difficult trick catches (behind-the-back, under-the-leg, one-handed wheel) while maintaining balance on a line or conducting fast partner-tossing rallies. The game tests risk-reward decision-making between executing high-value, high-difficulty maneuvers versus maintaining safe, sustained cascade catches.
## Formal model
- **Abstraction taken:** Physical trajectory throwing, hand velocity, and tactile catching are abstracted into a stochastic catch success function `P(Catch) = f(Routine_Difficulty, Juggler_Skill, Fatigue)`. The strategic dimension focuses on routine selection, fruit count escalation (3 vs. 5 vs. 7 fruits), and risk calibration.
- **Player/agent count:** 1 solo agent (or 2 competing agents in alternating rounds or synchronous passing rally).
- **Turn model:** Sequential attempt rounds across a 3-tier routine progression.
## Formal rules
R1. Setup:
- Each player begins with a bank of 3 wild orange tokens (escalating up to 5 or 7 in advanced stages).
- Player base skill `S in (0, 1]` is fixed or calibrated. Fatigue `F = 0`.
- Score `Score = 0`.
R2. Routine Selection & Execution:
- In each routine round, the active agent selects a maneuver from the catalog:
- `Basic_Cascade_3`: 3 fruits, base catch count target = 30. Difficulty `D = 0.10`. Point value = 10 pts.
- `Behind_Back_Catch`: 3 fruits, blind rear catch. Difficulty `D = 0.35`. Point value = 25 pts.
- `Under_Leg_Catch`: 3 fruits, leg lift catch. Difficulty `D = 0.30`. Point value = 20 pts.
- `Karatte_Wheel`: 2 fruits in one hand. Difficulty `D = 0.40`. Point value = 30 pts.
- `Advanced_Cascade_5`: 5 fruits cascade. Difficulty `D = 0.55`. Point value = 50 pts.
- `Master_Cascade_7`: 7 fruits cascade. Difficulty `D = 0.80`. Point value = 100 pts.
R3. Catch Probability & Fault Resolution:
- [gap-fill] Catch success probability for each maneuver attempt is defined by:
`P(Success) = max(0.05, min(0.98, S * (1.0 - D) - 0.02 * F))`.
- Sample uniform random `u in [0, 1]`:
- If `u <= P(Success)`: Maneuver succeeds. `Score += Point_Value`, `Fatigue += 1`. Agent may bank score or attempt a combo chain.
- If `u > P(Success)`: Fault / Drop occurs. The routine breaks. Unbanked combo points for that routine are lost, and the agent receives 1 Strike (*fault*).
R4. Elimination / Round End:
- An agent's turn/round ends upon receiving 3 cumulative Strikes or upon completing `M_max = 10` successful routine selections.
R5. [gap-fill] Partner Rally Mode (2 Agents):
- Agents alternate tossing passes back and forth. Tempo increases by `Delta_tempo = +0.05` per pass.
- The first agent to fail a catch check concedes the round point to the opponent.
R6. Win Condition:
- In solo/tournament mode, the player with the highest total score after 3 routine rounds wins.
## Edge cases
- Tie at the end condition: Equal scores resolved by highest single-maneuver difficulty completed, or declared a shared victory.
- A player with no legal move: Not applicable — the basic cascade action is always available.
- Repetition / cycles: Bounded by max 3 strikes or 10 maneuver attempts per round, guaranteeing finite execution.
- Simultaneous claims on the same resource: Not applicable — solo routines are isolated, partner rallies alternate synchronously.
- Player elimination mid-round: Upon reaching 3 strikes, the player's round terminates immediately and final score is locked.
- Resource exhaustion: Dropped fruits cannot be reused within the active combo chain; a dropped fruit counts as a strike.
- Termination guarantee: Strike counter monotonically increases on failure and attempt count monotonically increases on success, guaranteeing termination.
## State representation
- Persistent state:
- `total_score` (integer): Cumulative match score.
- `strikes` (integer `0..3`): Fault counter.
- `fatigue_level` (integer): Accumulated fatigue index.
- `completed_maneuvers` (list of completed trick IDs).
- Per-turn ephemeral state:
- `selected_maneuver` (string ID).
- `current_combo_score` (integer).
- `sampled_outcome` (boolean: success or drop).
- Observable information: Fully observable — all maneuver point values, success probabilities, strike count, and opponent scores are public.
## Action space
- `attempt_maneuver(trick_id)`:
- Select and execute a specific trick or cascade tier from the available catalog.
- `bank_and_pass()`:
- Voluntarily end the combo chain to securely bank current combo points and recover fatigue (`Fatigue = max(0, Fatigue - 3)`).
## Playability notes
- Single-player-vs-AI: Natural push-your-luck risk optimization problem. The AI evaluates expected value of banking vs. attempting high-tier 5-fruit or 7-fruit combos.
- Group games (n>4): Extends naturally as an arcade-style leader-board tournament with seeded rounds.
- Physical-skill games: Continuous hand-eye timing is abstracted to stochastic catch success functions parameterized by skill and maneuver difficulty.
- What is lost in the adaptation: The visual beauty of flying green and orange citrus globes and physical peripheral balance.
## Implementation hints
Very low complexity, highly deterministic scoring around a single stochastic sampler. Easily modeled as an MDP (Markov Decision Process) for AI policy optimization. Milestone 1: implement catalog data structures, catch probability formula, and combo banking state machine in under 80 lines.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Orange-Tossing and Juggling Contest (Sri Lanka). (n.d.). Games of Countries. https://gamesofcountries.com/games/lk-sri-lanka/dodan-keliya
@misc{gamesofcountries-lk-sri-lanka-dodan-keliya,
title = {Orange-Tossing and Juggling Contest (Sri Lanka)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/lk-sri-lanka/dodan-keliya}
}