Formal Specification
Persian Polo — Formal Specification
Iran · equestrian-team · Confidence: low
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: discretizedGap-fills: 1
# Chogan — AI-optimized specification
## General idea
A high-velocity equestrian ball invasion game governed by spatial "Line of the Ball" right-of-way mechanics. Agents manage mount stamina, vector velocity, and mallet swing angles to maintain possession, execute passing sequences, and score goals while avoiding crossing fouls and executing legal ride-offs.
## Formal model
- **Abstraction taken:** The 275x145 meter field is discretized into a 2D continuous coordinate space simulated across discrete ticks (`0.5s` per tick). Mounted agents possess vector velocity `v = (vx, vy)` bounded by horse maximum speed, and turning radius constraints. The ball possesses independent continuous physics with rolling friction and bouncing.
- **Player/agent count:** 2 teams of 4 mounted agents (Team 0: Agents 0..3, Team 1: Agents 4..7).
- **Turn model:** Real-time ticked simulation. All agents declare actions simultaneously each tick.
## Formal rules
R1. Field and Goal Topology:
- Pitch: `x ∈ [-137.5, 137.5]`, `y ∈ [-72.5, 72.5]`.
- Team 0 Goal: Line segment `x = -137.5`, `y ∈ [-3.65, 3.65]`.
- Team 1 Goal: Line segment `x = 137.5`, `y ∈ [-3.65, 3.65]`.
R2. Match Structure:
- Match consists of 4 chukkers, each lasting 840 simulation ticks (`7 minutes`).
- Chukkers start with a central bowl-in at `(0,0)` with ball velocity initialized toward center.
R3. Line of the Ball (LOB) Dynamics:
- The moving ball defines a dynamic vector ray `LOB = pos_ball + t * vel_ball`.
- Right of way belongs to the agent closest to the LOB whose angle of approach is most parallel to `vel_ball`.
- If another agent crosses within distance `d < 5.0m` across the LOB in front of the right-of-way agent, a `Crossing_Foul` is triggered.
- `Crossing_Foul` penalty: Play stops; opponent receives an uncontested free hit from the spot of the foul.
R4. Agent Action Execution per Tick:
- `steer_and_accelerate(target_heading, target_speed)`: Adjusts mount velocity subject to max acceleration and turning rate limits.
- `strike_ball(stroke_type, power, angle)`: Valid when `dist(agent_pos, ball_pos) <= 2.5m`.
- `stroke_type ∈ {OFFSIDE_FORE, OFFSIDE_BACK, NEARSIDE_FORE, NEARSIDE_BACK}`.
- Ball receives impulse: `vel_ball_new = vel_agent + power * mallet_power * direction(angle) + noise`. [gap-fill]
- `ride_off(target_opponent_id)`: Valid when adjacent (`dist < 2.0m`) and moving at similar angle (`diff_angle < 30°`). Applies lateral displacement force to push opponent off trajectory.
- `hook_mallet(target_opponent_id)`: Valid when adjacent and opponent is in swinging state. Cancels opponent strike with `P(hook) = skill_hook`.
R5. Scoring and End Inversion:
- If `ball_pos` crosses between goal posts: Team receives 1 point.
- Field orientation inverts (Team 0 and Team 1 swap defensive goal sides).
- Ball is reset to `(0, 0)` for a new bowl-in.
R6. Win Condition:
- Team with higher goal score at the end of Chukker 4 wins. If tied, a golden-goal sudden-death chukker is initiated.
## Edge cases
- **Tie at the end condition:** Overtime golden-goal chukker resolves ties cleanly.
- **A player with no legal move:** Mounted agents always retain steering and deceleration options.
- **Repetition / cycles:** Bounded by strict tick countdown per chukker (840 ticks x 4 = 3360 ticks maximum).
- **Simultaneous claims on the same ball position:** Resolved by the Line of the Ball right-of-way hierarchy (R3).
- **Player elimination mid-round:** Fouls do not eliminate players; penalties result in territorial free hits.
- **Resource exhaustion:** Horse stamina drains under sustained gallop, capping top speed to a baseline trot if exhausted.
- **Termination guarantee:** Guaranteed by finite chukker tick limits.
## State representation
- **Persistent state:**
- `scores: Tuple[int, int]`.
- `current_chukker: int` (1..4).
- `chukker_tick: int` (0..840).
- `team_directions: Tuple[int, int]` (indicating attack direction +/- 1 along x-axis).
- **Ephemeral tick state:**
- `agent_positions: Array[8] of Vector2D`.
- `agent_velocities: Array[8] of Vector2D`.
- `agent_stamina: Array[8] of float` (0.0..100.0).
- `ball_position: Vector2D`.
- `ball_velocity: Vector2D`.
- `lob_ray: Tuple[Vector2D, Vector2D]`.
- `right_of_way_agent_id: Optional[int]`.
- **Information set:** Fully observable common knowledge.
## Action space
- `steer(heading: float, throttle: float)`: Continuous navigation control.
- `strike(stroke: enum, power: float, aim_angle: float)`: Precondition: in striking range of ball.
- `ride_off(target_id: int)`: Precondition: parallel proximity with opponent.
- `hook(target_id: int)`: Precondition: adjacent to swinging opponent.
- `hold()`: Maintain current heading and velocity.
## Playability notes
- **Single-player-vs-AI:** Highly engaging. Player controls the team tactical pivot (Number 3), setting up line breaks and passes while AI teammates fill defensive and forward roles.
- **Group games:** Simulates as 4v4 multi-agent reinforcement learning or hierarchical planning problem.
- **Physical-skill model:** Horse acceleration inertia, turning radius limits, and mallet swing timing are modeled with kinematic physics.
- **What is lost:** Equine biomechanics, live horse temperament, and physical mallet vibrations.
## Implementation hints
Focus on building the Line of the Ball detector first; it is the fundamental rule that prevents collisions and structures team positioning. Implement a 2D physics tick resolving horse momentum before ball impulses.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Persian Polo (Iran). (n.d.). Games of Countries. https://gamesofcountries.com/games/ir-iran/chogan
@misc{gamesofcountries-ir-iran-chogan,
title = {Persian Polo (Iran)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ir-iran/chogan}
}