Formal Specification
Gaelic Football — Formal Specification
Ireland · ball-team · Confidence: low
← Back to game pageImplementation Suitability
Suitability: adaptation-requiredFidelity: discretizedGap-fills: 2
# Peil Ghaelach — AI-optimized specification
## General idea
A dynamic territory-and-possession team sport where two teams move a ball across a segmented grid using alternating foot and hand controls. Structurally distinctive mechanisms include the mandatory toe-lift from the ground, the strict alternation between bounces and foot-solos during forward movement, and dual scoring paths (over the crossbar for 1 point, under the crossbar into the net for 3 points).
## Formal model
- **Abstraction taken:** The continuous 140m field is discretized into a 7×5 zone grid (Defensive Goal, Defensive 20m, Defensive 45m, Midfield, Attacking 45m, Attacking 20m, Attacking Goal). Movement steps are mapped to discrete sub-ticks. Physical challenges (toe-lift, solo carry, open-palm tackle, contested high catch) are resolved through stochastic skill formulas.
- **Player/agent count:** 2 teams of 15 agents in full simulation; 2 team-controller agents in standard match engines.
- **Turn model:** Simultaneous-move discrete time ticks (200 total ticks per match, 100 per half).
## Formal rules
R1. Setup: Pitch is represented as a 7×5 grid. Midfielders start in the center zone; defenders and forwards occupy their designated initial sector positions. Score begins at 0–0.
R2. On each tick, active agents simultaneously declare actions (`toe_lift`, `bounce_advance`, `solo_advance`, `hand_pass`, `kick_pass`, `shoot_point`, `shoot_goal`, `tackle`).
R3. Lifting mechanic: An agent cannot pick the ball from `Loose_Ground` with hand directly; must execute `toe_lift()`, succeeding with probability `P = f(skill_lift, opponent_pressure)`.
R4. Ball-carrying rule:
- An agent holding the ball has a step counter (0..4).
- Moving one zone increments the step counter by 4.
- At step count 4, the agent must execute either `bounce_ball()` or `solo_ball()` to reset steps to 0.
- Double bounce restriction: An agent cannot execute `bounce_ball()` twice consecutively. [gap-fill] Executing a second consecutive bounce triggers an automatic technical foul turnover.
R5. Hand-passing: Executed as `hand_pass(target_agent_id)`. Ball must be struck with a visible fisting or palm-strike motion.
R6. Scoring:
- `shoot_point()`: Valid from Attacking 45m, 20m, or Goal zone. Successful kick over the crossbar yields +1 point.
- `shoot_goal()`: Valid from Attacking 20m or Goal zone. Successful kick or airborne fist-strike into the net past the goalkeeper yields +3 points.
R7. [gap-fill] Field restarts (kick-out, 45m free kick, sideline kick) consume 1 discrete tick and must be aimed at an open or contested zone.
R8. The match terminates at tick 200. The team with the highest aggregate score `(3 × goals + points)` wins.
## Edge cases
- Tie at the end condition: Match ends in a draw in regular league mode; initiates 20 ticks of extra time in knockout mode.
- A player with no legal move: Not applicable; an agent with the ball can always attempt `kick_clearance()` or `hand_pass()`.
- Repetition / cycles: Strictly prevented by the monotonic global countdown of 200 ticks.
- Simultaneous claims on the same resource or position: When two agents contest an aerial ball simultaneously, outcome is resolved by comparing `skill_high_catch + jump_stat + dice_roll`.
- Player elimination mid-round: An agent receiving a red card is removed; their zone remains understaffed for the remainder of the simulation without disrupting turn synchronization.
- Resource exhaustion: Time ticks are finite; grid boundaries are absolute.
- Termination guarantee: Guaranteed by the finite monotonic tick decrement from 200 to 0.
## State representation
- Persistent state: Scores (Goals, Points) for Team A and Team B, elapsed tick counter, 7×5 zone occupancy grid with agent IDs, card penalty trackers.
- Per-player state: Attributes (`skill_toe_lift`, `skill_solo`, `skill_kick`, `skill_tackle`), possession status (`None`, `Loose`, `Carrying`), consecutive bounce flag (`boolean`), current step count (0..4).
- Per-turn ephemeral state: Declared simultaneous actions, contest resolution outputs, turnover events.
- Observable information: Full visibility of grid positions and scores; declared action intentions remain private until simultaneous tick resolution.
## Action space
- `toe_lift()`: Lift ball from turf into hands using foot.
- `solo_advance(direction)`: Kick ball off toe back to hands while moving one zone.
- `bounce_advance(direction)`: Bounce ball off turf to hands while moving one zone (precondition: last advance was not a bounce).
- `hand_pass(target_id)`: Fist or strike ball to teammate in same or adjacent zone.
- `kick_pass(target_id)`: Kick ball over 1–3 zones.
- `shoot_point()`: Attempt 1-point shot over crossbar.
- `shoot_goal()`: Attempt 3-point goal into net.
- `tackle(target_id)`: Attempt to dislodge ball with open hand or apply legal shoulder check.
## Playability notes
- Single-player-vs-AI: Excellent as a high-level strategic playbook manager or 1v1 tactical duel.
- Group games (n>4): Cleanly abstracted to 2 macro team agents managing 15 simulated players on the field grid.
- Physical-skill games: High catches, solo speed, and kicking accuracy are modeled as `P(success) = base_prob * (agent_rating / pressure_modifier)`.
- What is lost: The exact aerodynamic curl of the football, dynamic running swerve, and physical body collisions are abstracted into statistical zone outcomes.
## Implementation hints
Treat possession as a finite-state machine attached to the active ball carrier. Enforce the double-bounce and 4-step invariants at every state transition. First milestone: construct the ball-carrying finite-state machine (ground → toe-lift → solo → bounce → pass) and verify all movement constraints before adding multi-agent tackling.
Download as JSON
Download the full game corpus entry for this game as structured JSON.
Download JSONCite this page
Gaelic Football (Ireland). (n.d.). Games of Countries. https://gamesofcountries.com/games/ie-ireland/peil-ghaelach
@misc{gamesofcountries-ie-ireland-peil-ghaelach,
title = {Gaelic Football (Ireland)},
year = {n.d.},
publisher = {Games of Countries},
url = {https://gamesofcountries.com/games/ie-ireland/peil-ghaelach}
}