Skip to main content
Formal Specification

Folk Football — Formal Specification

Ireland · ball-team · Confidence: low

← Back to game page

Implementation Suitability

Suitability: adaptation-requiredFidelity: discretizedGap-fills: 4
# Caid — AI-optimized specification ## General idea An unconstrained territory-conquest folk football simulation where two opposing factions attempt to transport a heavy leather ball across a rugged graph of terrain nodes to breach the opposing parish boundary. Strategic choices center on formation wrestling (wedge defense around the carrier) versus perimeter flanking, kicking breakthroughs, and stamina management over unrestricted terrain. ## Formal model - **Abstraction taken:** The open multi-mile natural landscape is modeled as an undirected connected graph of terrain nodes (Meadow, Bog, River, Ditch, Crossroads, Parish Goal) with distinct traversal costs and contest friction modifiers. Real-time wrestling scrums are discretized into simultaneous multi-agent strength-and-leverage resolution contests per tick. - **Player/agent count:** 2 teams of N agents (standardized to 8 agents per side for discrete multi-agent tactical engines). - **Turn model:** Simultaneous-move discrete time ticks (max 150 ticks per match). ## Formal rules R1. Setup: Board is a connected graph of 15–20 terrain nodes with Team A Goal at one end and Team B Goal at the other. The ball begins at the central `Neutral_Crossroads` node. Agents start deployed in their home sector nodes. R2. On each tick, every agent declares one action: `advance(neighbor_node)`, `tackle(target_carrier)`, `form_wedge(target_carrier)`, `kick_ball(target_node)`, or `lateral_pass(teammate)`. R3. Ball carrier movement: A carrier attempting `advance(neighbor_node)` succeeds without contest if no opposing agents occupy the target node or enter the carrier's node during the tick. R4. Scrum resolution: If opposing agents intercept or tackle the carrier: - Total defending tackle power = `Sum(defender_strength + defender_grit)` modified by node terrain penalties. - Total offensive protection power = `carrier_strength + Sum(wedge_blocker_strength)`. - If Tackle > Protection, the carrier is tackled; [gap-fill] ball transitions to `Loose_Contested` status in the current node. If Protection ≥ Tackle, carrier retains possession and completes the advance. R5. Kicking: An agent may kick the ball toward an adjacent node, bypassing intervening physical scrums with probability `P = f(kick_skill, distance)`. [gap-fill] If the kick misses target agents, the ball lands as `Loose_Uncontrolled` in the target node. R6. River & Bog hazards: [gap-fill] Traversal of wetland nodes imposes a 50% movement delay (2 ticks to cross) and doubles tackle fatigue. R7. Victory condition: When an agent carrying the ball enters the opponent's `Parish_Goal` node, that agent's team scores 1 Goal and immediately wins the game. R8. [gap-fill] Termination cap: If no goal is scored within 150 ticks, the team whose ball position is geographically closer to the opponent's goal node at tick 150 is declared the winner on territorial dominance; exact tie results in a draw. ## Edge cases - Tie at the end condition: Evaluated at tick 150 by measuring graph distance from ball to opposing goals; if equidistant, resolved as a draw. - A player with no legal move: Not applicable; an agent can always hold position or attempt a tackle/block. - Repetition / cycles: Bounded strictly by the global 150-tick limit. - Simultaneous claims on the same resource or position: When multiple agents attempt to seize a `Loose_Contested` ball simultaneously, resolution is calculated by comparing agent agility + random roll. - Player elimination mid-round: If an agent's stamina drops to 0 (exhaustion/injury), the agent enters an `Incapacitated` state for 10 ticks before recovering, without altering turn synchronization. - Resource exhaustion: Ball cannot be destroyed; terrain graph is persistent; global ticks are bounded. - Termination guarantee: Guaranteed by the monotonic countdown of the 150-tick match limit. ## State representation - Persistent state: Node graph topology, node terrain types, node occupancy lists (agent IDs), ball location and status (`Carried(agent_id)`, `Loose_Uncontrolled`, `Loose_Contested`), elapsed ticks. - Per-player state: Physical attributes (`strength`, `agility`, `kicking`, `grit`), current stamina (0..100), current assigned action. - Per-turn ephemeral state: Declared simultaneous actions, scrum contest outcomes, stamina expenditures. - Observable information: Full visibility of graph nodes, agent locations, and ball status; declared tick actions are revealed simultaneously. ## Action space - `advance(node_id)`: Move along graph edge to adjacent terrain node. - `tackle(agent_id)`: Engage opposing ball carrier in physical contest. - `form_wedge(agent_id)`: Assign agent to shield and absorb tackles for allied ball carrier. - `kick_ball(node_id)`: Project ball over 1–2 nodes. - `lateral_pass(agent_id)`: Hand-off or toss ball to adjacent teammate. - `recover_ball()`: Attempt to pick up loose ball in current node. ## Playability notes - Single-player-vs-AI: Functions cleanly as a team commander directing multi-agent squad formations over a territorial map. - Group games (n>4): Reduced to 2 faction commanders each controlling 5 to 8 agents. - Physical-skill games: Historical brute strength and stamina are modeled as quantitative scalar parameters feeding the scrum resolver. - What is lost: The raw, chaotic visceral reality of hundreds of rural parishioners fighting through actual mud, brambles, and river torrents is abstracted into a clean node-graph simulation. ## Implementation hints Model the terrain as an undirected graph with edge weights representing terrain difficulty (e.g. bog = weight 2, meadow = weight 1). The core engine loop needs only two components: a path movement resolver and a simultaneous multi-agent sum-of-forces scrum equation.

Download as JSON

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

Download JSON
Cite this page

Folk Football (Ireland). (n.d.). Games of Countries. https://gamesofcountries.com/games/ie-ireland/caid

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