Skip to main content
Formal Specification

Gaelic Handball — Formal Specification

Ireland · ball-team · Confidence: high

← Back to game page

Implementation Suitability

Suitability: engine-readyFidelity: discretizedGap-fills: 2
# Liathróid Láimhe — AI-optimized specification ## General idea A turn-based rally sport on an enclosed or one-wall court where two agents alternately strike a high-rebound ball against a front wall. Points are scored exclusively on serve; winning a rally as receiver triggers a side-out (turnover of service) rather than an immediate score increment. ## Formal model - **Abstraction taken:** The 3D continuous handball court trajectory (wall rebounds, angles, ceiling shots, kill shots) is discretized into a 2D court grid (Front-Left, Front-Center, Front-Right, Mid-Court, Deep-Left, Deep-Right) with trajectory-and-shot classification tables. Physical hand striking is modeled as a parameterized stochastic contest `P(successful_return) = f(shot_type, court_coverage, agent_skill)`. - **Player/agent count:** 2 agents (Singles) or 4 agents (Doubles). - **Turn model:** Strictly sequential rally turns within an outer service-possession state machine. ## Formal rules R1. Setup: Court is divided into 6 zones. Server begins in Service Zone (`Mid_Court`). Receiver stands in `Deep` court. Score begins at 0–0; server has active serve. R2. Service execution: - Server declares `serve(trajectory_type, target_zone)`. - Ball must hit Front Wall and bounce past the short line into target receiver zone. - [gap-fill] A serve error creates 1 fault; 2 consecutive faults trigger an automatic `side_out()` (receiver becomes server). R3. Rally exchange: - Active agent must choose `return_shot(shot_type, target_wall_aim, target_floor_zone)`. - Shot types: `kill_shot` (low front wall), `passing_shot` (deep perimeter), `ceiling_shot` (defensive lob), `pinch_shot` (corner angle). - Agent successfully returns if `roll(skill_check) >= difficulty_rating(opponent_shot_type, distance_to_ball)`. R4. Rally termination: - If an agent fails to return before the second floor bounce, or hits out of bounds, the rally ends. R5. Scoring and Service Transition: - If Server wins the rally: Server score increments by +1 point. Server retains serve. - If Receiver wins the rally: No points awarded. State transitions via `side_out()`: Receiver becomes the new Server. R6. Game and Match Win: - Game 1 & 2: First agent to reach exactly 21 points wins the game (no two-point advantage requirement, per official GAA Handball rules). - [gap-fill] If games are tied 1–1, Game 3 is played to exactly 11 points. Match winner is the first to win 2 games. ## Edge cases - Tie at the end condition: Not applicable; points are awarded sequentially one by one, and reaching 21 (or 11) triggers immediate termination. - A player with no legal move: Not applicable; an agent facing a return always has the legal action set of available shot selections. - Repetition / cycles: Bounded, because every rally has a strictly positive probability of termination `P(rally_end) >= epsilon > 0`, ensuring finite expected rally length. - Simultaneous claims on the same resource: Not applicable; turns in a rally alternate strictly sequentially. - Player elimination mid-round: In doubles, a fault or lost serve by Server 1 passes serve to Server 2 ("Hand 2"); a lost rally by Server 2 triggers a full `side_out`. - Resource exhaustion: None; rubber ball and court are permanent. - Termination guarantee: Guaranteed by the non-zero failure rate per rally combined with the monotonic score ceiling (21 / 11 points). ## State representation - Persistent state: Game scores (Server score, Receiver score), games won per agent (0..2), current game index (1..3), active server ID, server fault counter (0..1). - Per-rally ephemeral state: Active striker ID, ball location zone, incoming shot difficulty, consecutive rally stroke counter. - Observable information: Fully observable by both agents (court positions, scores, incoming shot vector). ## Action space - `serve(type, target_zone)`: Valid only when server; type ∈ {`power_drive`, `lob`, `z_serve`, `crack`}. - `return_shot(type, target_zone)`: Valid for active striker during rally; type ∈ {`kill_shot`, `passing_shot`, `ceiling_lob`, `pinch_corner`}. ## Playability notes - Single-player-vs-AI: Highly natural 1v1 turn-based strategic duel. - Group games (n>4): Not applicable; court sport strictly capped at 2 (singles) or 4 (doubles). - Physical-skill games: Court positioning, anticipation, and hand striking power are mapped cleanly to an attribute matrix (`power`, `control`, `speed`, `court_sense`). - What is lost: High-speed real-time spin physics, wall lip friction anomalies, and physical exhaustion are discretized into probabilistic skill checks. ## Implementation hints State transitions map directly to a two-level finite state machine: Outer FSM manages Service/Side-out and Score updates; Inner FSM executes the sequential rally stroke loop until a miss occurs. First milestone: implement the deterministic 21-point service-scoring FSM with placeholder random return success rates before tuning the shot-type matchup table.

Download as JSON

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

Download JSON
Cite this page

Gaelic Handball (Ireland). (n.d.). Games of Countries. https://gamesofcountries.com/games/ie-ireland/liathroid-laimhe

@misc{gamesofcountries-ie-ireland-liathroid-laimhe,
  title = {Gaelic Handball (Ireland)},
  year = {n.d.},
  publisher = {Games of Countries},
  url = {https://gamesofcountries.com/games/ie-ireland/liathroid-laimhe}
}