Formal Specification
Gaelic Handball — Formal Specification
Ireland · ball-team · Confidence: high
← Back to game pageImplementation 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 JSONCite 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}
}